文本安全检测服务器

连接MCP客户端与chakoshi API的协议服务器,用于执行文本内容安全检测。

  • by nttcom
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 nttcom/chakoshi-mcp-server

使用说明

chakoshi MCP服务器

MCP客户端应用程序API 类型的多个类型参数的着色器的编译器中可能发生的故障。

通过Claude Desktop等使用chakoshi的API,可以进行文本的安全性判定。

什么是chakoshi

chakoshi是NTTDoCoMo业务提供的面向LLM的护栏。详细情况请看下面。

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个字符)

出力:

  • 以JSON格式返回来自chakoshi Guardrails应用API的评估结果

使用提示示例:


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

设置chakoshi API

获取API密钥

  1. chakoshi的游戏中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。

  2. 新注册和登录完成后,单击“重放回合设置”。

  3. 然后,从设置画面新发行API密钥。

创建护栏

要使用chakoshi的Guardrails应用API,必须预先完成策略设置并提交护栏标识。

单击功能区上的创建快速启动护栏来修改标记元素的显示属性。

必要要件

  • 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=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应用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密钥的速率限制等正式文档来修改标记元素的显示属性。

许可证

麻省理工学院