claimscope

claimscope

claimscope 是连接到托管式 ECCA MCP 服务的轻量本地桥接工具。ECCA 是一款面板式引擎，用于深入探究主张和问题。它不会只依赖单个模型的回答，而是比较上游服务配置的各个引擎给出的回答，指出它们的分歧，运行对抗式事前验尸和决策锦标赛，验证其他 AI 撰写的候选回答；对于心理学、学习、营养和金钱相关问题，还会检索学术研究，并在给出结论前评估结论背后的证据。

桥接工具本身不持有任何答案，也不评估任何内容。它会在本地提供上游服务的工具列表——与从实时端点捕获的内容完全一致——并将每次工具调用转发至上游，原样返回结果。捕获到的部分工具描述中提到了“带密钥的层级配额槽位”；这是上游自己的措辞，桥接工具会原样提供。本客户端不会自行添加任何配额或支付机制，只有在你提供凭据时才会发送凭据（参见“配置”）。

工具

• ecca_synthesize — 比较配置的各个引擎针对单个查询（必填：query）给出的回答，并检查它们之间的分歧：在可测量时，比较词汇相似度和最终答案的一致程度。可选参数：model（在结果中回显的标签）、depth（从单引擎快速路线到多引擎深度路线）和 antagonist（指定一个引擎担任红队角色）。
• ecca_pre_mortem — 通过模拟计划或前提（必填：premise）如何失败，对其进行压力测试：找出失败模式和早期预警指标，并通过实证论证验证进行核查。可选参数：horizonMonths（默认值为 18）。
• ecca_decision_tournament — 在决策背景（必填：decisionContext）下，对离散选项（必填：options）进行评分，采用极小化最大后悔值和帕累托排序。
• ecca_bts_divergence — 衡量候选 assertions（必填）之间的词汇和语义差异，并对谄媚式的近似重复内容进行惩罚。
• ecca_refine — 在不添加事实的前提下，完善粗略的问题（必填：text，最多 2000 个字符）；返回检测到的领域和完善选项。
• ecca_research — 从学术索引中检索并评估与 question（必填）相关的研究，返回检索到的证据和明确指出的空白。可选参数：niche（psychology、learning、nutrition 或 money）。
• ecca_verify — 独立回答 question，并将 candidate_answer（两者均为必填）与确定性面板的一致意见进行比较，同时显示具名异议。
• ecca_psychology — 针对心理学问题（必填：question）进行完善、检索研究，并在给出结论前列出具名主张。
• ecca_learning — 针对学习或学习技巧问题（必填：question），采用相同的证据和主张处理流程。
• ecca_nutrition — 针对营养或补充剂问题（必填：question），采用相同的处理流程。
• ecca_money — 针对金钱或商业问题（必填：question），采用相同的处理流程。
• ecca_claim_protocol_validate — 仅检查一份 ecca.claim-protocol 1.0 document（必填）的结构：版本信息、引擎槽位而非供应商名称、源自已发布分类法的原因、对问题文本的同意，以及密封标记。返回包含错误列表的 ok；它只验证文档结构，绝不验证其背后的记录。

配置

• ECCA_MCP_URL（可选）— 覆盖上游端点。默认值为 https://eccaai.com/api/mcp。（此覆盖钩子是本次重建中自行标注的还原内容。）
• ECCA_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key>。未设置时，完全不会发送身份验证标头；本次重建所依据的原始捕获内容未使用密钥。（此身份验证转发是本次重建中自行标注的还原内容。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo 名称为 claimscope），随后发送 notifications/initialized 通知，再发送携带调用方参数且不做更改的 tools/call 请求。上游通过 Mcp-Session-Id 标头响应 initialize 后，该值会随会话的每个后续请求 一同发送；该会话会在进程的整个生命周期内复用。 响应可能是纯 JSON，也可能是服务器发送的事件； 两种格式都会读取。

成功的上游结果会原样传递， 包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态、 无法读取响应，或无法完成的请求——会以 isError 结果返回，其文本以 claimscope error: 开头（此呈现方式 是本次重建自行添加的标记）。

命令行

每个工具也可作为子命令使用，并接收一个 JSON 参数字符串：

npx @reneturcios/claimscope ecca_verify '{"question":"does spaced repetition work?","candidate_answer":"yes, robustly"}'
npx @reneturcios/claimscope ecca_decision_tournament '{"decisionContext":"hire or contract","options":["hire","contract","defer"]}'
npx @reneturcios/claimscope ecca_refine '{"text":"why do i forget things"}'
npx @reneturcios/claimscope --version

退出代码：成功时为 0，结果为 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/claimscope mcp

MCP 客户端配置：

{
  "mcpServers": {
    "claimscope": {
      "command": "npx",
      "args": ["-y", "@reneturcios/claimscope", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/claimscope
docker run --rm ghcr.io/cloudcorprecords/claimscope --version

容器的默认命令为 mcp，因此第一种 形式是 stdio MCP 服务；其他任何参数都会照常传递给 命令行。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全基于存根 JSON-RPC 上游运行——不会发起实时网络调用。

许可证

MIT — 参见 LICENSE。