chakoshi MCP Server

Servidor MCP chakoshi

Es un servidor MCP (Model Context Protocol) que conecta aplicaciones cliente MCP con la API de chakoshi.

Desde Claude Desktop y otras aplicaciones, puede utilizar la API de chakoshi para realizar evaluaciones de seguridad de texto.

¿Qué es chakoshi?

chakoshi es una salvaguarda para LLM proporcionada por NTT Docomo Business. Para más detalles, consulte lo siguiente:

Página de producto de chakoshi

Detalles técnicos de chakoshi

Sitio de documentación de chakoshi

Herramientas incluidas en el repositorio

Estructura de este repositorio

chakoshi-mcp-server/

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

├── chakoshi_server/

│ ├── __init__.py

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

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

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

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

moderate_text

Es una herramienta que verifica el contenido de texto con las salvaguardas de chakoshi.

Parámetros de entrada:

• text (string, obligatorio): El texto a verificar (máximo 2000 caracteres)

Salida:

• Devuelve el resultado de la evaluación de la API Guardrails Apply de chakoshi en formato JSON

Ejemplo de prompt de uso:

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

Configuración de la API de chakoshi

Obtención de la clave de API

1. Acceda al playground de chakoshi y siga el flujo de registro de nuevo usuario según las instrucciones en pantalla.

2. Después de completar el registro y el inicio de sesión, haga clic en Configuración del playground.

3. Luego, emita una nueva clave de API desde la pantalla de configuración.

Creación de salvaguardas

Para utilizar la API Guardrails Apply de chakoshi, debe completar la configuración de políticas con antelación y tener emitido un ID de salvaguarda.

Para conocer el procedimiento de configuración de políticas y emisión del ID de salvaguarda, consulte Creación de salvaguardas de inicio rápido.

Requisitos

• Python 3.10 o superior

• Registro de usuario de chakoshi, clave de API e ID de salvaguarda

• Aplicación cliente MCP (como Claude Desktop)

Instalación

1. Clonar el repositorio

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

cd chakoshi-mcp-server

2. Instalar dependencias

# uvのインストール
curl -LsSfhttps://astral.sh/uv/install.sh | sh


# PATHの設定
source $HOME/.local/bin/env


# uv を使用する場合（推奨）

uv sync


# pip を使用する場合

pip install -e .

3. Configurar variables de entorno

Cree el archivo .env y configure las siguientes variables de entorno:

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

Nota: Obtenga la clave de API real y el ID de salvaguarda desde la pantalla de administración del playground de chakoshi.

Método de uso

Inicio del servidor

uv run main.py

Integración con Claude Desktop

Agregue lo siguiente al archivo de configuración de Claude Desktop (claude_desktop_config.json):

{

"mcpServers": {

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

}

Luego, puede usarlo dentro de Claude Desktop de la siguiente manera:

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

Claude utilizará automáticamente la herramienta moderate_text para devolver los resultados de moderación.

Ejemplo de respuesta de la API

Extrae y devuelve el campo assessments de la respuesta de la API Guardrails Apply.

{
  "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": "チェック対象のテキスト"
    }
  }
}

Notas

• La API de chakoshi se encuentra actualmente en versión beta. No la utilice en entornos de producción.

• Administre adecuadamente la clave de API y nunca la haga pública.

• Para conocer los límites de tasa de la clave de API, consulte la documentación oficial.

Licencia

MIT