chakoshi

This MCP server integrates chakoshi moderation capabilities with an MCP client application. It exposes a toolset that enables you to send Japanese text content to chakoshi for toxicity and appropriateness checks, returning structured moderation results. The server is written in Python and is intended to be run via the UV (ud) runner, with the main entry point at main.py. To use it, configure your MCP client to point at the uv-based server command and path, and supply the necessary API key and identifiers to chakoshi for the moderation API. When connected, clients can invoke the moderate_text style checks through the standard MCP protocol, and receive category-based scores and verdicts (e.g., safe/unsafe) as demonstrated by the API response examples in the project.

Prerequisites:

• Python 3.10 or higher
• Access to chakoshi API with an API key
• MCP client application (e.g., Claude Desktop)

Installation steps:

1. Clone the repository and navigate into it

git clone https://github.com/nttcom/chakoshi-mcp-server.git
cd chakoshi-mcp-server

2. Install UV (Python-based runner) as instructed by the project:

# Install uv (per the project guidelines)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Update PATH if needed
source $HOME/.local/bin/env

# Install dependencies (editable mode recommended)
pip install -e .

3. Create and configure environment variables

CHAKOSHI_API_KEY=your_chakoshi_api_key
CHAKOSHI_API_URL=https://api.beta.chakoshi.ntt.com/v1/judge/text
CHAKOSHI_MODEL_ID=chakoshi-moderation-241223
CHAKOSHI_CATEGORY_SET_ID=your_category_set_id
CHAKOSHI_TIMEOUT_SEC=5

4. Run the server (UV-based entry point)

uv run main.py

5. Configure your MCP client to point at the server using the appropriate command and directory settings (as shown in the sample Claude Desktop integration in the README).

Notes and tips:

• The chakoshi API is in beta; do not rely on it for production workloads.
• Keep your API key confidential and rotate it periodically via the chakoshi playground settings.
• Ensure Python 3.10+ is installed and available in the environment where the MCP server runs.
• The server expects environment variables CHAKOSHI_API_KEY, CHAKOSHI_API_URL, CHAKOSHI_MODEL_ID, CHAKOSHI_CATEGORY_SET_ID, and CHAKOSHI_TIMEOUT_SEC; set sensible defaults or verify values before starting.
• If you encounter network or API throttling issues, check your API key and category set ID validity in the chakoshi Playground settings.