Perspective API Alternative (Toxicity Detection)

Perspective API の代替：有害性検出 MCP サーバー

このリポジトリには、stdio トランスポート用の MCP サーバーが含まれています。このサーバーは、AI エージェントに analyze_toxicity という 1 つのツールを提供します。エージェントがテキストを公開する前に、このツールでテキストを検査してください。

このツールは、各テキストについて 0 から 1 までの 6 つのスコアと、フラグ付きかどうかを返します。

• TOXICITY、SEVERE_TOXICITY、INSULT、PROFANITY、THREAT、IDENTITY_ATTACK

スコアはオープンソースの Detoxify モデルによるものです。このモデルは LLM ではありません。そのため、同じテキストには常に同じスコアが付与されます。英語のみ対応しています。

リクエストとレスポンスの形式は、Google Perspective API と同じです。Google は 2026 年 12 月 31 日に Perspective API の提供を終了します。

サーバーの動作

サーバーの実装は、このリポジトリの server.py です。Python の標準ライブラリのみを使用します（Python 3.9 以降）。

• サーバーは stdin から JSON-RPC メッセージを読み取り、stdout にレスポンスを書き込みます。
• サーバーは initialize、ping、tools/list に自ら応答します。これらのメッセージにトークンは必要ありません。
• tools/call の場合、サーバーはテキストを Apify の有害性 API に送信し、スコアを返します。
• 有害性 API は Detoxify モデルを実行します。呼び出しごとに Apify アカウントを通じて料金が発生します。

要件

• Python 3.9 以降、または Docker
• APIFY_TOKEN 環境変数に設定した Apify API トークン

トークンを取得するには、Apify Console を開きます。次に、Settings > API & Integrations に移動します。

インストール

Python

1. リポジトリをクローンします。

   git clone https://github.com/koyourmoon/perspective-api-alternative-mcp.git
   

2. MCP クライアントの設定にサーバーを追加します。

   {
     "mcpServers": {
       "perspective-api-alternative": {
         "command": "python",
         "args": ["/path/to/perspective-api-alternative-mcp/server.py"],
         "env": { "APIFY_TOKEN": "<APIFY_TOKEN>" }
       }
     }
   }
   

Docker

1. イメージをビルドします。

   docker build -t perspective-api-alternative-mcp .
   

2. MCP クライアントの設定にサーバーを追加します。

   {
     "mcpServers": {
       "perspective-api-alternative": {
         "command": "docker",
         "args": ["run", "-i", "--rm", "-e", "APIFY_TOKEN", "perspective-api-alternative-mcp"],
         "env": { "APIFY_TOKEN": "<APIFY_TOKEN>" }
       }
     }
   }
   

ツール：analyze_toxicity

パラメーター	型	説明
texts	文字列の配列、必須	スコアを付ける英語テキスト（1～100 件）
attributes	文字列の配列	返す属性。デフォルトでは 6 つすべてです。
threshold	数値	テキストにフラグを付ける TOXICITY スコア。デフォルトは 0.5 です。

1 件のテキストに対する結果の例：

{
  "results": [
    {
      "text": "You are an idiot.",
      "scores": { "TOXICITY": 0.98, "INSULT": 0.95, "PROFANITY": 0.62 },
      "flagged": true,
      "billed_units": 1
    }
  ]
}

テキストが英語以外と思われる場合、結果には warning フィールドが含まれます。そのテキストのスコアは信頼できません。

環境変数

名前	必須	説明
APIFY_TOKEN	tools/call に必須	Apify API トークン
PERSPECTIVE_ALT_URL	いいえ	有害性 API の別の URL

料金

• テキスト 1,000 ユニットあたり 0.50 ドル。1 ユニットは、テキストの 1,000 文字ごとに切り上げて計算されます。ほとんどのコメントは 1 ユニットです。
• Apify Bronze、Silver、Gold プランでは料金が割引されます。
• 60 秒間アイドル状態が続いた後の最初の呼び出しには、10～30 秒かかることがあります（コールドスタート）。

リモート接続（任意）

MCP クライアントを有害性 API に直接接続することもできます。この接続では server.py を使用しません。

項目	値
トランスポート	Streamable HTTP
URL	https://koyourmoon--perspective-api-alternative.apify.actor/mcp
認証	Authorization: Bearer <APIFY_TOKEN>

ファイル

ファイル	内容
server.py	MCP サーバー
Dockerfile	サーバーのコンテナーイメージ
glama.json	Glama のメンテナーデータ
server.json	公式 MCP Registry のエントリー

リンク

• Apify Store ページ：https://apify.com/koyourmoon/perspective-api-alternative
• 大規模なジョブ向けの Batch Actor：https://apify.com/koyourmoon/toxicity-detector

ライセンス

MIT。このプロジェクトは Google または Jigsaw と提携していません。「Perspective API」は Google LLC の商標です。