Hallucc MCP Server

HallucC MCP Server

English ｜ 在线体验 ｜ 官方 MCP Registry ｜ 魔搭 MCP 广场 ｜ Coze 商店

给 AI 装上「事实核验 + 安全网关」：逐声明幻觉检测、Agent 轨迹六维评估、CUA 动作 L0-L3 风险分级、Agent 源码静态审计、40+ 特征注入/越狱拦截——一个 MCP server，五个工具，接入 Claude Code / Cursor / Claude Desktop。

零注册，先看真实效果

• 🔍 真实检测结果示例（含逐句标注 + 置信度 + 来源链接）：https://aihcc.cloud/r/GttouoJfMpkC
• 🛡️ CUA 动作分级在线体验（纯规则，不耗额度）：https://aihcc.cloud/cua
• 📝 网页版检测（免费额度 2 次/天）：https://aihcc.cloud

工具集（5 个）

鉴权模型：客户端在各自机器配 Authorization: Bearer <你的 HallucC API key> 头 → server 提取并原样透传到后端 → 后端校验 + 扣同一账号额度。key 只在 HTTP 头里流转，不进工具参数、不进模型 transcript。

公网接入（推荐，无需本地运行）

MCP server 已部署在 https://aihcc.cloud/mcp（remote，streamable-http）。客户端直接配公网地址 + 个人 API key 即可：

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

Cursor / Claude Desktop 同理，URL 填 https://aihcc.cloud/mcp，Headers 加 Authorization: Bearer <key>。API key 在 https://aihcc.cloud 注册后于 /keys 页创建，免费套餐每日有额度。

或：npx 本地运行（stdio，无需 clone）

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

同一套工具，走 stdio 传输，key 从环境变量读取，默认连公网后端 https://aihcc.cloud/api。

base 必须带 /api 前缀：nginx 只把 /api/ 代理到后端。填裸域名 https://aihcc.cloud 会打到前端页面， 返回 200 但 body 是 HTML——请求静默失败（审计不落库、不落兜底文件），审计回放里看不到任何记录。

本地运行（源码开发）

# 1. 装依赖（已装可跳过）
npm install

# 2.（可选）配置后端地址与端口；默认指向本机 8001
cp .env.example .env
#   HALLUCC_BASE_URL=http://127.0.0.1:8001
#   PORT=8787

# 3. 确保后端在跑：curl http://127.0.0.1:8001/health
# 4. 起 MCP server（dev 热重载）
npm run dev
# 或生产：npm start

服务监听 http://127.0.0.1:8787/mcp，健康检查 GET /health。

客户端接入

Claude Code（CLI）

# remote HTTP transport，带个人 key 头
claude mcp add --transport http hallucc http://127.0.0.1:8787/mcp \
  --header "Authorization: Bearer <你的 HallucC API key>"

# 验证
claude mcp list
# 在对话里调用：让 Claude 核验一段文本的幻觉 / 检测一段 prompt 的注入风险

Cursor

Settings → MCP → Add MCP server：

• Type: http
• URL: http://127.0.0.1:8787/mcp
• Headers: {"Authorization": "Bearer <你的 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 <你的 HallucC API key>" }
    }
  }
}

MCP Inspector（调试 / 不带额度也能测工具列表与鉴权）

npx @modelcontextprotocol/inspector
# 选 Streamable HTTP，URL 填 http://localhost:8787/mcp
# Custom Headers 加 Authorization: Bearer <key>

鉴权与额度

• 无 Authorization 头或 key 无效 → MCP 层返回 401 JSON-RPC 错误。
• key 有效但额度耗尽 → 后端返回 429，server 映射成「免费额度已用完，请明天重置或升级套餐」。
• 每个工具响应里的 quota 对象 = 后端 quota_status，与 Web 仪表盘同源、随调用递减。
• check_cua_actions 与 check_cua_code_audit 均为纯规则，不调 LLM、不耗额度，可放心高频调用。

项目结构

src/
  server.ts     Express + StreamableHTTP transport（stateless）+ 鉴权中间件 + 注册工具
  context.ts    配置加载 + API key 提取
  backend.ts    BackendClient（透传 key、统一 401/429/5xx 错误映射）+ toMcpResult
  schemas.ts    5 工具 zod 输入 schema（约束对齐后端 Pydantic Field）
  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

传输

Streamable HTTP（当前 MCP 规范推荐的 remote 传输，即「HTTP+SSE」），stateless 模式：每个 POST 新建 transport + McpServer，处理完即关。Claude Code / Cursor / Claude Desktop 均原生支持。后续若要兼容只认旧版 SSE 的客户端，加 SSEServerTransport（双端点 /sse + /messages）即可。

收录与生态

• ✅ 官方 MCP Registry：io.github.fredyee/hallucc v0.1.1（active）
• ✅ 魔搭 MCP 广场：@hallucC/hallucc
• ✅ 扣子 Coze 商店：HallucC 事实核查助手

License

MIT