HallucC MCP Server 是一个面向 AI 幻觉检测与智能体安全的 MCP 服务器，包含五个工具，可与 Claude Code / Cursor / Claude Desktop 配合使用。

一、主要能力

二、CUA 动作门控的收紧机制

离开 task_scope 的动作会被提升一个级别（L0→L1，L1→L2，L2 保持 L2 并附加“outside task scope”原因，L3 不变）。该机制只收紧、不放松；省略 task_scope 无效果。
凭据字段与支付/登录域名会产生 takeover 判定（暂停并等待用户自行输入——智能体永远不会输入密码）。
多智能体场景（Claude Code Task 子智能体、Codex agents、Kimi 等）：父智能体读取凭据文件（自身 L0）→ 子智能体将其外发（自身 L2），单跳无害但作为链式行为危险。为每个动作附加委托链字段后，后端会追加 chain_trace：当存在跨智能体传播时，链聚合级别提升至 L3 并设置 risk_diluted（洗白信号）。链字段留空时行为逐位不变，现有调用方无需改动。
响应中的 ruleset_version 可用于核对在线检测与本地 Gate 是否运行相同规则版本。

三、使用方式 A. 托管端点（推荐，无需本地设置）

MCP 服务器托管于 https://aihcc.cloud/mcp（远程，streamable-http）。
Cursor / Claude Desktop 用法相同：URL 为 https://aihcc.cloud/mcp，请求头 Authorization: Bearer <key>。
在 https://aihcc.cloud 创建 API key（注册 → /keys），含免费每日配额。

B. 通过 npx 运行（stdio，无需克隆）

同样五个工具，经由 stdio 传输；密钥来自环境变量，请求默认指向托管后端 https://aihcc.cloud/api。
base URL 必须保留 /api 前缀：nginx 仅将 /api/ 代理到后端。裸 https://aihcc.cloud 会到达前端——请求返回 200 且为 HTML 正文，静默失败（审计与回退文件均为空），审计回放保持为空。

C. 从源码本地运行

Claude Code（CLI）配置：Settings → MCP → Add MCP server：

Claude Desktop 配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json。

MCP Inspector 可用于调试——工具列表与鉴权可在不消耗配额的情况下工作。

四、鉴权模型

每个客户端发送 Authorization: Bearer <your HallucC API key> → 服务器原样转发至后端 → 后端验证并从与 Web 应用相同的账户配额中扣减。密钥仅在 HTTP 头中传输——绝不出现在工具参数中，也绝不出现在模型记录中。
MCP 层的鉴权分两级。tools/call（及任何非发现方法）要求格式有效的密钥（hc_ + 48 位十六进制），否则返回 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、无配额成本，可安全高频使用。

五、传输与注册

Streamable HTTP（当前 MCP 规范推荐的远程传输，旧称 HTTP+SSE），无状态模式：每个 POST 启动新的 transport + McpServer，完成后关闭。原生支持 Claude Code / Cursor / Claude Desktop。为支持仅 SSE 的旧客户端，可添加 SSEServerTransport（双端点 /sse + /messages）。
已收录于：官方 MCP Registry（io.github.fredyee/hallucc v0.1.9，active）、ModelScope MCP Square（@hallucC/hallucc）、Coze Store（HallucC Fact-Check Assistant）。

六、适用场景

七、限制

hallucc-mcp

工具介绍