servidor MCP de chakoshi

MCPクライアントアプリケーションと、chakoshiAPI を連携するMCP (Model Context Protocol) サーバーです。

Claude Desktop などからchakoshiを利用して日本語テキストのモデレーション(有害性チェック)を実行できます。

chakoshiとは

chakoshiとは、NTT ドコモビジネスが提供するLLM向けのガードレールです。詳細は以下をご覧ください。

chakoshi 製品ページ

chakoshi 技術詳細

chakoshi ドキュメントサイト

リポジトリに含まれるツール

本リポジトリの構成

chakoshi-mcp-server/ ├── main.py # エントリポイント ├── chakoshi_server/ │ ├── __init__.py │ ├── config.py # 環境変数の管理 │ └── server.py # MCP サーバーの実装部分 ├── pyproject.toml # プロジェクト設定 └── .env # 環境変数（要作成）

moder_text

テキストコンテンツの有害性をチェックするツールです。

入力パラメータ:

• texto (cadena, 必須): チェックしたいテキスト

出力:

• chakoshi API からのモデレーション結果をJSON形式で返します

使用プロンプト例:

chakoshi を使ってこのテキストをチェックしてください: "問題のあるコンテンツの例"

chakoshi API の設定

API キーの取得

1. chakoshiのプレイグラウンドにアクセスし、画面に従って新規登録フローを進めてください。

2. 新規登録、およびログイン完了後、プレイグラウンドの設定をクリックします。

3. その後、設定画面からAPIキーを新規に発行します。

カテゴリセットの設定

1. プレイグラウンドにアクセスし、「新しいカスタム検知項目の追加」をクリックし、検知項目名とカスタム検知項目の定義を入力します。

2. 別名で保存を選択し、新しくカスタム検知項目セットを保存します。

3. 保存後、「選択中の検知項目セットIDをコピー」の項目からカテゴリセットIDをコピーします。

必要要件

• Python 3.10 以上

• chakoshi のユーザ登録、および、APIキー

• MCPクライアントアプリケーション (Claude Desktopなど)

インストール

1. リポジトリのクローン

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

2. 依存関係のインストール

# uvのインストール curl -LsSfhttps://astral.sh/uv/install.sh | sh # PATHの設定 source $HOME/.local/bin/env # uv を使用する場合（推奨） uv sync # pip を使用する場合 pip install -e

3. 環境変数の設定

.env ファイルを作成し、以下の環境変数を設定してください：

CHAKOSHI_API_KEY=tu_chakoshi_api_key CHAKOSHI_API_URL=https://api.beta.chakoshi.ntt.com/v1/judge/text CHAKOSHI_MODEL_ID=chakoshi-moderación-241223 CHAKOSHI_CATEGORY_SET_ID=tu_category_set_id CHAKOSHI_TIMEOUT_SEC=5

注意:実際の APIキーとカテゴリセットID はchakoshiプレイグラウンドの管理画面から取得してください。

使用方法

サーバの起動

uv run main.py

Claude Desktop との連携

Claude Desktop の設定ファイル（claude_desktop_config.json）に以下を追加：

{ "mcpServers": { "command": "/PATH_to_uv/uv", "args": [ "--directory", "/PATH_to_chakoshi/chakoshi-mcp-server", "run", "main.py" ], "env": { "CHAKOSHI_API_KEY": "YOUR_CHAKOSHI_API_KEY" } }

その後、Claude Desktop 内で以下のように使用できます：

chakoshiを使ってこのテキストをチェックしてください：「問題のあるコンテンツの例」

Claude が自動的に moderate_text ツールを使用してモデレーション結果を返します。

API レスポンス例

{"category1": { "puntuación": 0.05, "umbral": 0.5, "resultado": "seguro" }, "category2": { "puntuación": 0.02, "umbral": 0.3, "result": "safe" } }

注意事項

• chakoshi API は現在ベータ版です。本番環境などでは使用しないでください。

• APIキーは適切に管理し、決して公開しないでください。

• APIキーのレート制限などについては公式ドキュメントを参照してください。

ライセンス

MIT