chakoshi MCP Server

chakoshi MCP Server

Este é um servidor MCP (Model Context Protocol) que integra aplicativos clientes MCP com a API chakoshi.

Você pode executar avaliações de segurança de texto usando a API chakoshi a partir do Claude Desktop e outros aplicativos.

O que é chakoshi

chakoshi é uma guardrail para LLMs fornecida pela NTT Docomo Business. Consulte abaixo para mais detalhes.

Página do produto chakoshi

Detalhes técnicos do chakoshi

Site de documentação do chakoshi

Ferramentas incluídas no repositório

Estrutura deste repositório

chakoshi-mcp-server/

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

├── chakoshi_server/

│ ├── __init__.py

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

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

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

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

moderate_text

Ferramenta que verifica o conteúdo de texto com as guardrails do chakoshi.

Parâmetros de entrada:

• text (string, obrigatório): o texto que deseja verificar (máximo de 2000 caracteres)

Saída:

• Retorna o resultado da avaliação da API chakoshi Guardrails Apply em formato JSON

Exemplo de prompt de uso:

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

Configuração da API chakoshi

Obtenção da chave de API

1. Acesse o playground do chakoshi e siga o fluxo de novo registro conforme as instruções na tela.

2. Após concluir o novo registro e o login, clique em Configurações no playground.

3. Em seguida, emita uma nova chave de API na tela de configurações.

Criação de guardrails

Para usar a API chakoshi Guardrails Apply, é necessário concluir a configuração de políticas com antecedência e emitir o ID da guardrail.

Consulte Criação de guardrails no guia de início rápido para obter os procedimentos de configuração de políticas e emissão do ID da guardrail.

Requisitos

• Python 3.10 ou superior

• Registro de usuário, chave de API e ID de guardrail do chakoshi

• Aplicativo cliente MCP (como Claude Desktop)

Instalação

1. Clonar o repositório

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

cd chakoshi-mcp-server

2. Instalar as dependências

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


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


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

uv sync


# pip を使用する場合

pip install -e .

3. Configurar as variáveis de ambiente

Crie o arquivo .env e configure as seguintes variáveis de ambiente:

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

Atenção: Obtenha a chave de API e o ID de guardrail reais na tela de administração do playground do chakoshi.

Como usar

Iniciar o servidor

uv run main.py

Integração com o Claude Desktop

Adicione o seguinte ao arquivo de configuração do Claude Desktop (claude_desktop_config.json):

{

"mcpServers": {

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

}

Em seguida, você pode usá-lo no Claude Desktop da seguinte forma:

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

O Claude usará automaticamente a ferramenta moderate_text para retornar os resultados de moderação.

Exemplo de resposta da API

Extrai e retorna o campo assessments da resposta da 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": "チェック対象のテキスト"
    }
  }
}

Avisos

• A API chakoshi está atualmente em versão beta. Não a use em ambientes de produção.

• Gerencie a chave de API adequadamente e nunca a torne pública.

• Consulte a documentação oficial para informações sobre limites de taxa da chave de API, entre outros.

Licença

MIT