chakoshi MCP Server

A bridge server connecting Claude Desktop with the chakoshi moderation API for content safety.

GitHub

chakoshi MCP Server

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

Claude Desktop などからchakoshiのAPIを利用して、テキストの安全性判定を実行できます。

chakoshiとは

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

chakoshi 製品ページ

chakoshi 技術詳細

chakoshi ドキュメントサイト

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

本リポジトリの構成


chakoshi-mcp-server/

├── main.py # エントリポイント

├── chakoshi_server/

│ ├── __init__.py

│ ├── config.py # 環境変数の管理

│ └── server.py # MCP サーバーの実装部分

├── pyproject.toml # プロジェクト設定

└── .env # 環境変数（要作成）

moderate_text

テキストコンテンツをchakoshiのガードレールでチェックするツールです。

入力パラメータ:

  • text (string, 必須): チェックしたいテキスト（最大2000文字）

出力:

  • chakoshi Guardrails Apply API からのアセスメント結果をJSON形式で返します

使用プロンプト例:


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

chakoshi API の設定

API キーの取得

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

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

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

ガードレールの作成

chakoshiのGuardrails Apply API を利用するためには、ポリシー設定をあらかじめ完了してガードレールIDを発行している必要があります。

ポリシー設定とガードレールIDの発行手順については、クイックスタート ガードレールの作成を参照してください。

必要要件

  • Python 3.10 以上

  • chakoshi のユーザ登録、APIキー、およびガードレールID

  • 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=your_chakoshi_api_key

CHAKOSHI_API_URL=https://api.beta.chakoshi.ntt.com/v1/guardrails/apply

CHAKOSHI_GUARDRAIL_ID=your_guardrail_id

CHAKOSHI_TIMEOUT_SEC=10

注意: 実際の 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"
        ]
}

}

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


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

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

API レスポンス例

Guardrails Apply API のレスポンスから assessments フィールドを抽出して返します。

{
  "guardrails": ["moderation", "keyword_filter"],
  "user_input": "チェック対象のテキスト",
  "guardrails_result": {
    "moderation": {
      "unsafe_flag": false,
      "unsafe_score": 0.05,
      "categories": {
        "violence": {
          "enabled": true,
          "detected": false
        },
        "harassment": {
          "enabled": true,
          "detected": false
        }
      }
    },
    "keyword_filter": {
      "matched": false,
      "matches": [],
      "original_text": "チェック対象のテキスト",
      "masked_input": "チェック対象のテキスト"
    }
  }
}

注意事項

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

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

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

ライセンス

MIT

Related Servers