AINumbers Fintech Intelligence Suite

AINumbers MCP Apps 服务端

Agent 按名称调用金融科技工具时，无法知道该工具是否真的执行了声称执行的计算。此服务端为 AINumbers.co 套件弥补了这一缺口：每次工具调用都是确定性的、不涉及任何 PII，并且直接提供该套件自己的单文件 HTML，而不是对其内容进行转述。

一个 MCP Apps（SEP-1865）服务端，可将 AINumbers.co 金融科技工具套件提供给任何 MCP 主机，包括 Claude、ChatGPT、M365 Copilot、VS Code 和 Cursor。

快速开始

# Claude: Settings -> Connectors -> Add custom connector
https://mcp.ainumbers.co/mcp

# Inspector
npx @modelcontextprotocol/inspector   # then Streamable HTTP -> the URL above

无需身份验证、API 密钥或账户。生产环境运行在 Cloudflare Workers 上（/healthz 报告 runtime: cloudflare-workers），因此不会冷启动。Cursor 和其他 Open Plugins 目录会通过根目录中的 .mcp.json 自动发现此仓库，该文件声明了相同的端点。

在线端点： https://mcp.ainumbers.co/mcp（可流式传输的 HTTP） · 文档： ainumbers.co/mcp.html · 注册表： 官方 MCP 注册表中的 co.ainumbers/tools

自行运行（由组织托管）

Fork 此仓库并点击上方按钮进行部署，即可在自己的 Cloudflare 账户中运行相同的服务端：无需添加身份验证，部署时无需构建步骤，Worker 会直接从此处已提交的 data/ 和 kernels/ 启动。

在全新账户上首次成功部署前，需要修改 wrangler.jsonc 中的两处设置：

• routes 指向 mcp.ainumbers.co，而此 Fork 并不拥有该域名区域。请重命名 name，并删除 routes（使用免费的 workers.dev 子域名部署），或将其指向自己账户中的域名区域。
• queues / workflows 用于内部分析循环，并在代码中受保护（if (env.EVENTS_QUEUE)、if (env.RENEWAL_WATCH_WORKFLOW)）——MCP 握手和所有工具调用无需它们也能正常工作。队列需要 Workers 付费计划；删除这两个区块即可继续使用免费层级。

其他所有内容，包括用于提供已提交工具数据的 ASSETS 绑定，都无需修改即可使用。完整说明（WAF 速率限制方案、重新引入依赖的周期、符合性证明服务）：ainumbers.co/mcp.html#deploy-your-own。

工具

只读 MCP 工具——此处有意不硬编码数量（上次这么做后，数量已经过时）。请查看 data/counts.json 获取实时数量；不要手动填写此数字，scripts/surface-parity.mjs 和网站仓库的数量漂移检查都会据此验证。下方的旗舰小组件会以交互式小组件形式呈现，其余工具是 ChainGraph 计算节点，以及少量目录和发现实用工具：list_ainumbers_tools、find_tool、find_chain、build_workflow_links、run_chain、verify_execution_hash、build_chaingraph、emit_chaingraph_artifact、build_session_receipt。

每个工具都声明 readOnlyHint: true。无需账户或身份验证，不涉及任何 PII，也不会修改状态。

旗舰小组件

每个小组件都会呈现为实际的单文件 AINumbers 工具，通过 text/html;profile=mcp-app 资源提供，并由 AIN Bridge 驱动（预填、运行、导出 Policy Mandate）。此表即为完整清单——行数就是小组件数量，切勿在其他地方手动填写数字：

MCP 工具	AINumbers 工具
baas_provider_comparator	T152 BaaS Provider Comparator
validate_ap2_mcp_policy	T320 AP2 MCP Policy Validator & Bridge
build_google_ap2_mandate	T285 Google AP2 Checkout/Payment Mandate Builder
score_mcp_readiness	T288 MCP Developer Readiness Scorecard
agentic_mandate_sandbox	RBE-06 Agentic Mandate Sandbox
customer_risk_rating	T110 Customer Risk Rating Engine
ap2_aml_mandate_builder	T131 AP2 AML Mandate Builder
lint_mcp_tool_definition	T274 MCP Tool-Definition Linter
validate_mcp_server_json	T275 MCP server.json Validator
compare_agentic_payment_protocols	T276 Agentic Payments Protocol Comparator
decode_x402_payment	T277 x402 Decoder & 402 Flow Simulator
audit_mcp_oauth	T278 MCP OAuth 2.1 Authorization Auditor
scan_tool_poisoning	T282 MCP Tool-Poisoning Scanner
validate_a2a_agent_card	T283 A2A Agent Card Validator
inspect_visa_tap_signature	T286 Visa TAP Signature Inspector
run_kernel_vm	Kernel VM Widget

list_ainumbers_tools 和 find_tool 会搜索完整目录（当前工具数量见 data/counts.json），并返回深层链接。支持预填的工具接受 #in=<base64url(JSON of {element_id: value})>[&run=1]，可一键调用。find_chain 和 build_workflow_links 会为指定的多工具工作流返回有序深层链接。run_chain 会在服务端执行工作流；每次运行都会返回一个 OpenTelemetry span 文档作为资源链接（每个已执行步骤对应一个 execute_tool span，位于 invoke_agent 父级 span 下）。verify_execution_hash 会独立重新验证返回产物的哈希值。

架构

../repo (site repo, PostOakLabs/ainumbers)
   |  chaingraph.json, manifests/, pilot.mjs-referenced tool HTML
   |
   v  node generate.mjs (build-time only, cannot run in cloud CI, needs the sibling repo)
data/       vendored: chaingraph.json, catalog.json, manifests, counts.json
kernels/    vendored: server-side compute kernels
   |
   v
worker.mjs  (Cloudflare Workers, this repo's live runtime)
server.mjs  (Node/express variant, local dev only, not deployed)
   |
   v
https://mcp.ainumbers.co/mcp   (the one live endpoint: the Worker, not the express variant)

data/ 和 kernels/ 是生成后提交的产物。Worker 从已提交的内容启动，而不是实时读取 ../repo。站点仓库中的 chaingraph.json、清单、pilot.mjs 或内核发生任何更改后，都必须在此处重新运行 generate.mjs，并在同一次推送中提交 data/ 和 kernels/，否则 Worker 部署的将是过时内容。

部署流程（由 CI 管理）

创建分支，然后提交 PR。CI 会运行 validate 作业：检查工具名称冲突、表面一致性、内核覆盖率、链验证、供应商版本新鲜度，以及运行 wrangler deploy --dry-run。合并到 master 后会运行 deploy 作业，该作业会使用 wrangler deploy 部署到 Cloudflare Workers，然后执行部署后 /mcp 冒烟测试（对线上端点发起真实的 initialize 调用）。绝不手动运行 wrangler deploy：Cloudflare Workers Builds 会刻意保持断开，因为同时运行两者会造成重复部署，过去曾因此导致服务中断。CI 全部通过并不能单独证明线上握手正常；只有冒烟测试步骤能证明这一点。

Dependabot 会自动合并所有依赖更新（补丁、次要和主要版本更新，均须通过 CI），因此推送任何本地分支前，请先运行 git pull --rebase，因为 master 会自行更新。

独立监控

MCP Queen 是第三方运行探测服务：它会持续重新检查线上 /mcp 端点的协议握手和工具架构响应，并根据观测结果进行评级。这并非我们或对方出具的安全或合规认证——它仅描述可观测到的服务端行为。

开发

npm install
node generate.mjs   # re-vendor tool HTML + manifests + catalog + kernels from ../repo into data/ + kernels/
npm start           # http://localhost:3300/mcp (+ /healthz), Node/express variant (server.mjs), local dev only
node scripts/check-tool-names.mjs   # verify no mcp_name collision before pushing
node scripts/surface-parity.mjs     # verify counts.json matches the registered surface

pilot.mjs 是小组件工具集的唯一事实来源。在站点仓库中更改任何 pilot 工具后，运行 node generate.mjs，提交 data/ 和 kernels/，然后推送。CI 会进行验证和部署。

所有工具内容均在客户端运行、具有确定性，且不包含任何 PII。代码采用 MIT 许可证（参见 LICENSE）；内容采用 CC BY 4.0 许可证，归 Post Oak Labs 所有。架构和历史记录请参见 README-SPEC.md。

传输一致性（MCP-STREAMABLE-HTTP-CONFORMANCE-1）。 /mcp 入口是符合 MCP 规范（2025-03-26 / 2025-06-18）的完整 Streamable HTTP 端点：initialize 会签发 Mcp-Session-Id（之后的请求会回传该 ID，但它从不属于必需项——服务在幕后是无状态的）；使用 Accept: text/event-stream 和该会话 ID 请求 GET /mcp，会打开一个服务端到客户端的 SSE 流，该流每隔 25 s 发送一次 keepalive，并在连接断开时关闭（不带会话 ID 的 GET 仍会返回原本就有的、符合规范的 405 + Allow）；携带会话 ID 请求 DELETE /mcp 会以 204 结束会话（不带会话 ID 的 DELETE 仍返回 405）；未知的 MCP-Protocol-Version 会触发 JSON-RPC 400（绝不会是 500）；tools/list 会遵循 params.cursor 并返回 nextCursor（worker.mjs 中的页面大小 TOOLS_LIST_PAGE_SIZE 特意设为不小于单个发布版本的完整工具集）。使用零依赖的六项检查脚本验证任一入口——本地入口（node server.mjs）或生产环境入口：bash scripts/transport-conformance.sh [BASE_URL]。

幂等性与重试（RUN-1-1）。 每次工具调用都具有确定性：安全重试就是重新运行，并返回字节完全一致的产物（generated_at/opened_at 会不同；哈希不会变）；run_chain 会回显稳定的 dedupe: { input_hash, composite_execution_hash }，供客户端去重。去重属于缓存问题，而非正确性问题。非无状态的例外情况（RenewalWatchWorkflow、scheduled()、queue()、MRTR_STATE_KEY requestState、input_required 流程、共享缓存提示、null-strip 实时与黄金结果偏差类别）记录在 docs/IDEMPOTENCY.md 中；KV/Cache 回执缓存（D2）仍暂缓实施。