firmproof

firmproof

firmproof 是一个小型本地桥接服务，可连接 Fuentio 托管的 MCP 服务，用于根据法国、西班牙和英国的官方注册簿核验公司。提供 官方 ID——法国 SIREN、西班牙 Registro Mercantil 登记簿编号或英国 Companies House 编号——即可读取登记簿记录、核验公司以供 入驻、根据制裁名单进行筛查、检查破产情况、地址和 VAT，并追踪 一段时间以来的变更；每项结果都附有官方来源。

该桥接服务不保存任何登记簿数据。它会在本地提供上游服务的工具 列表，内容与从实时端点捕获的内容完全一致；并将每次工具 调用转发至上游，原样返回结果。

工具

• lookup_company — 根据官方 ID 查询一家公司的信息：状态、 地址、法律形式、业务活动、来源和检查日期。 必填：country（FR、ES 或 GB）、identifier。
• search_companies — 按名称查找公司，每页 10 条， 每条都包含匹配分数。必填：query、 country。
• get_company_history — 获取公司的登记记录 版本，以及发生变更的字段和对应来源。 必填：country、identifier。
• verify_company — 核验公司的登记信息，返回 结果、原因、检查项、警示信号，以及供审计人员使用的证明 代码。必填：country、identifier。
• get_receipt — 根据证明代码获取先前核验的 回执。必填：proof_code、format （normal 或 detailed）。
• resolve_company — 根据证据和候选判定，判断你持有的记录 是否对应登记簿中的某家公司。必填：country。
• explain_match — 说明两条登记簿记录为何是或 不是同一家公司。必填：left、right。
• what_changed — 查询某家公司自指定日期以来的变更。 必填：entity_id、since。
• screen_company — 根据制裁名单筛查公司的名称。必填：country、identifier。
• check_insolvency — 获取来自 BODACC 和 BORME 的破产公告和状态。必填：country、identifier。
• check_address — 根据官方地址数据库验证注册地址。 必填： country、identifier。
• get_graph — 查询公司的集团关系：GLEIF 母公司和子公司。必填：entity_id。
• report_issue — 报告错误或缺失的结果，以便根据官方来源重新核查。必填： subject、category、message。
• get_evidence — 获取公司各项事实背后的证据， 按字段逐项列出来源。必填： entity_id。
• check_vat — 查询公司的欧盟 VAT 号码及其获取方式（不会核查 注册本身）。 必填：country、identifier。
• watch_company — 注册你自己的 https 端点，以便在公司的记录发生变更时收到通知。必填： entity_id、callback_url。
• review_report — 生成一份可供审核的综合报告，包含身份信息、事实、一年来的变更和所有检查结果。 必填：country、identifier。
• check_supplier_list — 一次检查 2 到 100 家供应商，或读取你已启动的批次。没有必填字段： 传入 rows 或 batch_id。
• list_coverage — 查询涵盖的国家、ID 格式和 官方来源。不接受参数。

配置

• FUENTIO_MCP_URL（可选）— 覆盖上游 端点。默认为 https://api.fuentio.com/mcp。 （此覆盖接口是本次重建中特别标注的部分。）
• FUENTIO_API_KEY（可选）— 设置后，每个 上游请求都会携带 X-API-Key: <key> 标头。 部分上游工具需要密钥，可从供应商处免费获取。未设置时， 不会发送密钥标头。绝不会发送 Authorization 标头。 （此转发功能同样是特别标注的重建内容； 原始接口是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立一个可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo name firmproof），接着发送 notifications/initialized 通知，然后发送携带调用方原样参数的 tools/call 请求。当上游在响应 initialize 时返回 Mcp-Session-Id 标头后， 该值会随该会话的每个后续请求一起发送，并在进程的整个生命周期内复用。 响应可能是纯 JSON，也可能是服务器发送事件； 两种格式都会读取。

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

CLI

每个工具也都是一个子命令，接受一个 JSON 参数 字符串（不需要参数的工具可省略）：

npx @reneturcios/firmproof lookup_company '{"country":"FR","identifier":"441639465"}'
npx @reneturcios/firmproof search_companies '{"country":"FR","query":"renault"}'
npx @reneturcios/firmproof verify_company '{"country":"GB","identifier":"00445790"}'
npx @reneturcios/firmproof list_coverage
npx @reneturcios/firmproof --version

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

MCP 服务

npx -y @reneturcios/firmproof mcp

MCP 客户端配置：

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

Docker

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

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

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过桩接 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。