Perspective MCP Server 使用说明

项目简介

Perspective MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它集成了 Google 的 Perspective API，为大型语言模型 (LLM) 客户端提供文本分析工具。通过此服务器，LLM 可以调用 Perspective API 的功能，例如分析文本的毒性、侮辱、威胁等属性，并获取相应的评分。

主要功能点

文本毒性分析: 分析文本中是否存在 токсичность, 侮辱, 身份攻击, 亵渎, 威胁等有害内容。
评分建议: 允许用户为文本的特定属性（如毒性）提交建议评分，用于 Perspective API 的模型改进。
多语言支持: 支持 Perspective API 提供的多语言文本分析。
多属性分析: 支持分析多种文本属性，包括 TOXICITY, SEVERE_TOXICITY, IDENTITY_ATTACK, INSULT, PROFANITY, THREAT 等。

安装步骤

由于此 MCP 服务器以 npm 包的形式发布，你可以使用 'npx' 直接运行，无需全局安装。确保你的环境中已安装 Node.js 和 npm。

服务器配置

要将 Perspective MCP Server 添加到你的 MCP 客户端配置中，你需要提供以下 JSON 配置信息。请注意，你需要先获取 Google Cloud Perspective API 的密钥 (PERSPECTIVE_API_KEY) 并配置到环境变量中。

{
  "mcpServers": {
    "perspective": {
      "command": "npx",
      "args": [
        "-y",
        "@mtane0412/perspective-mcp-server"
        ],
      "env": {
        "PERSPECTIVE_API_KEY": "YOUR_PERSPECTIVE_API_KEY"
      }
    }
  }
}

配置参数说明:

'server name': 'perspective' (服务器名称，可自定义)
'command': 'npx' (用于执行 npm 包的命令)
'args':
- '-y': 'npx' 参数，自动确认安装包。
- '@mtane0412/perspective-mcp-server': Perspective MCP Server 的 npm 包名称。
'env': 环境变量配置
- 'PERSPECTIVE_API_KEY': [必须配置] 你的 Google Cloud Perspective API 密钥。请替换 'YOUR_PERSPECTIVE_API_KEY' 为你的实际密钥。

注意: 请务必将 'YOUR_PERSPECTIVE_API_KEY' 替换为你自己的 Perspective API 密钥。你需要在 Google Cloud Console 中创建项目并启用 Perspective API，然后生成 API 密钥。

基本使用方法

配置完成后，MCP 客户端可以通过 "perspective" 这个服务器名称来调用 Perspective MCP Server 提供的工具。

可用工具:

analyze_text: 分析文本的毒性等属性。

工具名称: 'analyze_text'
描述: 文本を分析し、有害性などのスコアを返します (分析文本并返回毒性等评分)

输入参数:

{
  "text": "待分析的文本内容",
  "attributes": ["TOXICITY", "SEVERE_TOXICITY"], // 可选，要分析的属性列表，默认为 ["TOXICITY"]
  "languages": ["ja", "en"] // 可选，文本语言代码列表，不指定则自动检测
}

输出: 返回 JSON 格式的分析结果，包含各个属性的评分。

suggest_score: 为文本的特定属性建议评分。

工具名称: 'suggest_score'
描述: テキストに対する新しいスコアを提案します (为文本提出新的评分建议)