HallucC — Hallucination & Safety Guardian

HallucC MCP サーバー

中国語ドキュメント ｜ ライブデモ ｜ 公式 MCP レジストリ

AI にファクトチェッカーとセーフティゲートウェイを提供します。主張ごとのハルシネーション検出、エージェントの軌跡評価、Computer-Use Agent（CUA）のアクションに対する L0～L3 のリスク判定、エージェントのソースコード静的監査、40 以上の機能を備えたプロンプトインジェクション／ジェイルブレイク対策を、1 つの MCP サーバーと 5 つのツールで実現します。Claude Code／Cursor／Claude Desktop で利用できます。

まずはお試しください — 登録不要です

• 🔍 実際の検証レポート（主張ごとの判定＋信頼度＋情報源）：https://aihcc.cloud/r/GttouoJfMpkC
• 🛡️ オンラインで CUA アクション判定を試す（ルールベース、無料、クォータ消費なし）：https://aihcc.cloud/cua
• 📝 Web アプリ（1 日 3 回まで無料でチェック）：https://aihcc.cloud

ツール（5）

ツール	バックエンドのエンドポイント	機能	クォータ
verify_text	POST /detect	主張ごとのハルシネーションチェック：赤／黄／緑の概要＋主張ごとのステータス／信頼度／理由／情報源＋引用	✅ detect
verify_agent	POST /detect-agent	エージェントの最終出力のテキストレベル検証＋6 つの観点による軌跡評価（事実性／情報源の提示／指示への準拠／ツールの主張との整合性／タスクの完了／振り返り）	✅ detect
check_cua_actions	POST /cua/classify	Computer-Use Agent（CUA）のアクションに対する L0～L3 のリスク分類＋takeover（認証情報に関するシナリオ）。機密パス／破壊的コマンド、ドメインの段階評価、支払い金額のしきい値、task_scope の意図からの逸脱、複数エージェントの委任チェーンにおける汚染分析に対応します。レスポンスには ruleset_version と disclaimer が含まれます（純粋なルールベースで、LLM は使用しません）	❌ 無料
check_cua_code_audit	POST /cua/audit-code	エージェントのソースコード静的監査：危険なインポート／権限境界／インジェクションの侵入経路／危険なデフォルト設定／サンドボックスの欠如	❌ 無料
check_safety	POST /guard/check（fast=true → /guard/check-fast）	40 以上の機能を備えたセーフティゲートウェイ：プロンプトインジェクション／ジェイルブレイク／有害コンテンツ／個人情報の漏えい／詐欺	✅ detect

認証方式：各クライアントは Authorization: Bearer <your HallucC API key> を送信します → サーバーはそのままバックエンドに転送します → バックエンドが検証し、Web アプリと同じアカウントのクォータから差し引きます。キーは HTTP ヘッダー内でのみ送信され、ツールの引数にもモデルのトランスクリプトにも含まれません。

check_cua_actions の機能を強化する設定

フィールド	効果
actions[].target_url / url	ブラウザーアクションの対象 URL — 未知のドメインへの移動は L2 にエスカレーションされます。機密情報を許可リストにないドメインに貼り付けると L3 にエスカレーションされ、ブラックリストに登録されたドメインは L3 になります
task_scope.task	実行するタスクを宣言します。逸脱の検出と監査の追跡に使用されます
task_scope.allowed_apps / allowed_domains	許可するアプリ／ドメイン（ドメインのサフィックス照合ではサブドメインも対象になります）
task_scope.forbidden_elements	禁止する要素のラベル（最優先）
actions[].chain_id	マルチエージェント委任チェーン ID（UUID の 16 進数表記） — 指定すると、応答にホップをまたいだ汚染分析を示す chain_trace が追加されます
actions[].agent_id / parent_agent_id	このアクションを実行するエージェント／委任元の親エージェント — エージェント境界をまたぐ伝播チェーンを組み合わせます
actions[].delegation_depth	委任の深さ（ルートエージェントは 0）。サブエージェントが機密パターンに一致する内容を外部に送信すると L2 になります

task_scope の範囲外となるアクションはリスクレベルが 1 段階引き上げられます（L0→L1、L1→L2、L2 は「タスク範囲外」の理由が追加されて L2 のまま、L3 は変更なし）。この仕組みはリスクレベルを引き上げるだけで、引き下げることはありません。task_scope を省略しても影響はありません。認証情報のフィールドや決済／ログイン用ドメインは takeover 判定になります（処理を一時停止し、ユーザー自身が入力するのを待ちます。エージェントがパスワードを入力することはありません）。

マルチエージェント構成（Claude Code の Task サブエージェント、Codex エージェント、Kimi など）の例：親エージェントが認証情報ファイルを読み取る（単独では L0）→ サブエージェントがその内容を外部に投稿する（単独では L2）場合、各ホップでは無害ですが、チェーン全体としては危険です。各アクションに委任チェーンのフィールドを追加すると、バックエンドが chain_trace を追加します。エージェント間の伝播が存在する場合はチェーン全体のリスクレベルが L3 に引き上げられ、risk_diluted が設定されます（リスク隠蔽の兆候）。チェーンのフィールドを空のままにすれば、動作はビット単位で変わりません。既存の呼び出し元に変更は不要です。

応答の ruleset_version を使って、オンライン検出とローカルの Gate が同じルールバージョンで動作していることを確認できます。

ホスト型エンドポイント（推奨、ローカル設定不要）

MCP サーバーは https://aihcc.cloud/mcp でホストされています（リモート、streamable-http）。API キーを使ってクライアントを接続します。

# Claude Code
claude mcp add --transport http hallucc https://aihcc.cloud/mcp \
  --header "Authorization: Bearer <your HallucC API key>"

Cursor／Claude Desktop も同様に設定できます。URL は https://aihcc.cloud/mcp、ヘッダーは Authorization: Bearer <key> です。https://aihcc.cloud で API キーを作成してください（登録 → /keys）。1 日あたりの無料利用枠が含まれます。

または：npx で実行（stdio、クローン不要）

{
  "mcpServers": {
    "hallucc": {
      "command": "npx",
      "args": ["-y", "hallucc-mcp"],
      "env": { "HALLUCC_API_KEY": "<your HallucC API key>" }
    }
  }
}

stdio トランスポートで同じ 5 つのツールを利用できます。キーは環境から取得され、リクエストはデフォルトでホスト型バックエンド https://aihcc.cloud/api に送信されます。

ベース URL には /api のプレフィックスを含めてください：nginx がバックエンドにプロキシするのは /api/ のみです。プレフィックスのない https://aihcc.cloud はフロントエンドに到達します。その場合、リクエストは HTML 本文とともに 200 を返して ひっそり失敗します（監査ログにもフォールバックファイルにも記録されず、監査リプレイも空のままです）。

ローカルで実行（ソースから）

# 1. Install dependencies
npm install

# 2. (Optional) configure backend address & port; defaults to local :8001
cp .env.example .env
#   HALLUCC_BASE_URL=http://127.0.0.1:8001
#   PORT=8787

# 3. Make sure the backend is up: curl http://127.0.0.1:8001/health
# 4. Start the MCP server (dev with hot reload)
npm run dev
# or production: npm start

サーバーは http://127.0.0.1:8787/mcp でリッスンします。ヘルスチェックは GET /health です。

クライアントの設定

Claude Code（CLI）

claude mcp add --transport http hallucc http://127.0.0.1:8787/mcp \
  --header "Authorization: Bearer <your HallucC API key>"

claude mcp list
# then in conversation: ask Claude to fact-check a passage or scan a prompt for injection

Cursor

Settings → MCP → Add MCP server：

• Type：http
• URL：http://127.0.0.1:8787/mcp
• Headers：{"Authorization": "Bearer <your HallucC API key>"}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "hallucc": {
      "type": "http",
      "url": "http://127.0.0.1:8787/mcp",
      "headers": { "Authorization": "Bearer <your HallucC API key>" }
    }
  }
}

MCP Inspector（デバッグ — 利用枠を消費せずにツール一覧と認証を確認できます）

npx @modelcontextprotocol/inspector
# choose Streamable HTTP, URL http://localhost:8787/mcp
# add Custom Header: Authorization: Bearer <key>

認証とクォータ

• 認証は MCP 層で 2 段階になっています。tools/call（およびディスカバリー以外のすべてのメソッド）には、形式が有効なキー（hc_ + 48 桁の 16 進数）が必要です。そうでない場合、バックエンドに接続する前に 401 の JSON-RPC を返します。 形式の検証にはローカルの正規表現を使い、バックエンドへのラウンドトリップは行いません。
• ディスカバリーメソッド（initialize、tools/list、ping、notifications/initialized）は、レジストリーやディレクトリーサイトがサーバーをインデックスできるよう、認証なしで利用できます。これらはバックエンドを呼び出さず、ユーザーデータも公開しません。これらにも制限をかけるには、MCP_ALLOW_ANON_DISCOVERY=0 を設定してください。
• キーが実際に有効かどうか（存在、失効、有効期限）は、常にバックエンドの verify_api_key が判定します。MCP 層の検証では、実在するキーである可能性のないトークンのみを拒否します。
• 有効なキーでもクォータが尽きている場合は、バックエンドが 429 を返し、「無料クォータを使い切りました。明日リセットされるまでお待ちいただくか、アップグレードしてください」と示すメッセージに変換されます。
• すべてのツール応答には quota オブジェクト（バックエンドの quota_status）が含まれます。Web ダッシュボードと同じ情報源を使用し、呼び出しごとに減算されます。
• check_cua_actions と check_cua_code_audit はどちらもルールのみで動作し、LLM を使わず、クォータも消費しません。高頻度の利用にも安全です。

プロジェクト構成

src/
  server.ts     Express + StreamableHTTP transport (stateless) + auth middleware + tool registration
  context.ts    config loading + API key extraction
  backend.ts    BackendClient (key pass-through, unified 401/429/5xx mapping) + toMcpResult
  schemas.ts    zod input schemas for the 5 tools (aligned with backend Pydantic Fields)
  tools/
    verifyText.ts       → /detect
    verifyAgent.ts      → /detect-agent
    checkCuaActions.ts    → /cua/classify
    checkCuaCodeAudit.ts  → /cua/audit-code
    checkSafety.ts        → /guard/check (fast → /guard/check-fast)
    index.ts            registerAllTools

トランスポート

ストリーミング可能な HTTP（現行の MCP 仕様で推奨されているリモートトランスポート。以前は「HTTP+SSE」）のステートレスモードです。POST ごとに新しいトランスポートと McpServer を起動し、処理が終わると終了します。Claude Code／Cursor／Claude Desktop でネイティブにサポートされています。レガシーな SSE 専用クライアントにも対応するには、SSEServerTransport（デュアルエンドポイント /sse + /messages）を追加してください。

掲載先

• ✅ 公式 MCP レジストリー：io.github.fredyee/hallucc v0.1.10（アクティブ）
• ✅ ModelScope MCP Square：@hallucC/hallucc
• ✅ Coze Store：HallucC ファクトチェックアシスタント

ライセンス

MIT