AINumbers MCP Apps Server 是 AINumbers.co 金融科技工具套件的 MCP 服务器实现,面向代理式金融科技工作流,提供只读、确定性、零 PII 的工具调用,并生成签名收据。
用途
代理按名称调用金融科技工具时,无法确认该工具是否真正执行了其声称的数学计算。本服务器为 AINumbers.co 套件填补这一缺口:每次工具调用都是确定性的、零 PII,且直接由套件自有的单文件 HTML 提供,而非其转述。
该服务器属于 MCP Apps(SEP-1865),可将 AINumbers.co 金融科技工具套件暴露给任何 MCP 主机,包括 Claude、ChatGPT、M365 Copilot、VS Code 和 Cursor。
主要能力
- 只读 MCP 工具:工具数量未在此硬编码,实时数字见 data/counts.json。所有工具声明 readOnlyHint: true,无账号、无认证、零 PII,不改变状态。
- 旗舰小部件:每个小部件渲染为实际的单文件 AINumbers 工具,作为 text/html;profile=mcp-app 资源提供,并由 AIN Bridge 驱动(prefill、run、Policy Mandate 导出)。
- 目录与发现工具:list_ainumbers_tools、find_tool 搜索完整目录并返回深链;find_chain、build_workflow_links 返回命名多工具工作流的有序深链;run_chain 在服务端执行;verify_execution_hash 独立重新验证返回工件的哈希;build_chaingraph、emit_chaingraph_artifact、build_session_receipt 等。
- 预填调用:支持预填的工具接受 #in=<base64url(JSON of {element_id: value})>[&run=1] 实现一键调用。
- 签名收据与哈希校验:每次调用确定性,安全重试返回字节一致的工件(generated_at / opened_at 不同,哈希不变);run_chain 回显稳定的去重标识 { input_hash, composite_execution_hash }。
使用方式
- 无需认证、API 密钥或账号。生产环境运行在 Cloudflare Workers 上,/healthz 报告 runtime: cloudflare-workers,无冷启动。
- Cursor 及其他 Open Plugins 目录会通过根目录 .mcp.json 自动识别本仓库,该文件声明同一端点。
- 在线端点:https://mcp.ainumbers.co/mcp(流式 HTTP)。
- 文档:ainumbers.co/mcp.html。
- 注册表:官方 MCP Registry 上的 co.ainumbers/tools。
- 自托管(组织自建):复刻本仓库并部署到自己的 Cloudflare 账号,无需添加认证、无构建步骤,Worker 直接从已提交的 data/ 和 kernels/ 启动。首次部署前需对 wrangler.jsonc 做两处编辑:routes 指向 mcp.ainumbers.co(分叉不拥有的 zone),重命名 name 并删除 routes(使用免费 workers.dev 子域)或指向自己账号的 zone;queues / workflows 供内部分析循环使用,代码中有守卫(if (env.EVENTS_QUEUE)、if (env.RENEWAL_WATCH_WORKFLOW)),MCP 握手和每次工具调用无需它们即可工作;队列需要 Workers Paid 计划,删除两个块即可保持免费层。
- 部署流程(CI 管理):分支后提 PR,CI 运行 validate 作业:工具名冲突、surface-parity、内核覆盖、链验证、供应商新鲜度及 wrangler deploy --dry-run。合并到 master 触发 deploy 作业,对 Cloudflare Workers 执行 wrangler deploy,然后进行部署后 /mcp 冒烟测试(对线上端点的真实 initialize 调用)。永远不要手动执行 wrangler deploy;Cloudflare Workers Builds 有意保持断开。
- 传输一致性(MCP-STREAMABLE-HTTP-CONFORMANCE-1):/mcp 是按 MCP 规范(2025-03-26 / 2025-06-18)的完整 Streamable HTTP 端点。initialize 发放 Mcp-Session-Id(此后回显,但非必需——服务器实际无状态);带 Accept: text/event-stream 和会话 ID 的 GET /mcp 打开服务器到客户端的 SSE 流,25 秒保活,断开时关闭(无会话 GET 保持规范的 405 + Allow);带会话 ID 的 DELETE /mcp 以 204 结束会话(裸 DELETE 保持 405);未知 MCP-Protocol-Version 返回 JSON-RPC 400(绝不 500);tools/list 遵循 params.cursor / 返回 nextCursor。可用零依赖六项检查脚本验证任何入口:bash scripts/transport-conformance.sh [BASE_URL]。
- 幂等与重试(RUN-1-1):每次工具调用确定性;安全重试返回字节一致工件。非无状态的例外情况(RenewalWatchWorkflow、scheduled()、queue()、MRTR_STATE_KEY requestState、input_required 流程、共享缓存提示、null-strip 实时与黄金漂移类)记录于 docs/IDEMPOTENCY.md;KV/Cache 收据缓存(D2)仍推迟。
适用场景
适用于需要可验证的代理式金融科技工具调用的场景,如代理式支付(AP2、x402、Visa TAP、A2A)、AML/KYC 风险评级、BaaS 供应商比较及 MCP 开发工具。适合希望将 AINumbers.co 工具套件接入 Claude、ChatGPT、M365 Copilot、VS Code、Cursor 等 MCP 主机的开发者与团队。
限制
- 工具为只读,不改变状态;不提供账户、认证或写入操作。
- 独立监控方面,MCP Queen 是第三方运维探针,持续复检线上 /mcp 端点的协议握手和工具模式响应并对其观察评分;这不是安全或合规证明。
- 代码为 MIT 许可(见 LICENSE);内容为 CC BY 4.0,Post Oak Labs。架构和历史见 README-SPEC.md。
- data/ 和 kernels/ 为生成并提交的工件,Worker 从提交内容启动,而非实时读取。对 chaingraph.json、清单、pilot.mjs 或站点仓库内核的任何更改都需要在此重新运行 generate.mjs 并在同一推送中提交 data/ 和 kernels/,否则 Worker 部署会过期。pilot.mjs 是小部件工具集的唯一事实来源。
- Dependabot 自动合并所有依赖更新(补丁、次要和主要,均经 CI 门控),推送本地分支前先执行 git pull --rebase。
- 产品功能、收费、价格、平台、效果或使用步骤等未在资料中提供的细节,暂未提供。