HallucC — Hallucination & Safety Guardian

HallucC MCP 服务

中文文档 ｜ 在线演示 ｜ 官方 MCP 注册表

为你的 AI 配备事实核查器和安全网关：逐条检测幻觉、评估 Agent 执行轨迹、对计算机操作 Agent（CUA）的操作进行 L0-L3 风险拦截、静态审计 Agent 源代码，以及具备 40 多项功能的提示词注入／越狱防护——一个 MCP 服务，五种工具，可与 Claude Code / Cursor / Claude Desktop 搭配使用。

先看效果——无需注册

• 🔍 查看真实核查报告（逐条判定 + 置信度 + 来源）：https://aihcc.cloud/r/GttouoJfMpkC
• 🛡️ 在线试用 CUA 操作拦截（基于规则，免费，不消耗配额）：https://aihcc.cloud/cua
• 📝 Web 应用（每天免费核查 3 次）：https://aihcc.cloud

工具（5 种）

工具	后端端点	功能	配额
verify_text	POST /detect	逐条检测幻觉：红／黄／绿摘要 + 每条内容的状态／置信度／原因／来源 + 引文	✅ detect
verify_agent	POST /detect-agent	对 Agent 的最终输出进行文本级核查 + 6 个维度的执行轨迹评估（事实准确性／来源引用／指令遵循／工具声明一致性／任务完成度／反思）	✅ detect
check_cua_actions	POST /cua/classify	对计算机操作 Agent（CUA）的操作进行 L0-L3 风险分类 + takeover（凭证相关场景）；涵盖敏感路径／破坏性命令、域名分级、支付金额阈值、task_scope 意图偏离，以及多 Agent 委派链污染分析；响应包含 ruleset_version 和 disclaimer（纯规则，不使用 LLM）	❌ 免费
check_cua_code_audit	POST /cua/audit-code	静态审计 Agent 源代码：危险导入／权限边界／注入入口／危险默认设置／缺少沙箱	❌ 免费
check_safety	POST /guard/check（fast=true → /guard/check-fast）	具备 40 多项功能的安全网关：提示词注入／越狱／有害内容／PII 泄露／欺诈	✅ 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	多 Agent 委派链 ID（uuid hex）——提供此字段时，响应会增加 chain_trace 跨跳污点分析
actions[].agent_id / parent_agent_id	执行此操作的 Agent / 委派它的父级 Agent——用于关联跨 Agent 边界的传播链
actions[].delegation_depth	委派深度（根 Agent = 0）；子 Agent 外传匹配敏感模式的内容时会获得 L2

离开 task_scope 的操作会升级一级（L0→L1、L1→L2、L2 保持 L2 并附加“超出任务范围”的原因、L3 不变）。此机制只会收紧，绝不会放宽；省略 task_scope 不会产生影响。凭据字段和支付 / 登录域名会给出 takeover 判定（暂停并等待用户亲自输入——Agent 绝不会输入你的密码）。

多 Agent 设置（Claude Code Task 子 Agent、Codex agents、Kimi，……）：父级 Agent 读取凭据文件（单独看为 L0）→ 子 Agent 将其发出（单独看为 L2），逐跳看无害，作为链来看则很危险。为每个操作附加委派链字段，后端会追加 chain_trace：存在跨 Agent 传播时，链的聚合级别会升至 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）。包含每日免费额度。

或：通过 npx 运行（stdio，无需克隆）

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

通过 stdio 传输提供相同的五种工具；密钥从环境中读取，请求默认发送至托管后端 https://aihcc.cloud/api。

基础 URL 必须保留 /api 前缀：nginx 仅将 /api/ 代理至后端。裸地址 https://aihcc.cloud 会访问前端——请求会返回状态码 200 和 HTML 正文， 并静默失败（审计记录和备用文件中均不会留下任何内容），审计回放也会保持为空。

本地运行（从源代码）

# 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：

• 类型：http
• URL：http://127.0.0.1:8787/mcp
• 请求头：{"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 层采用双层认证。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 都是纯规则检查——不使用大模型，也不消耗配额，可安全地高频使用。

项目结构

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