importproof

importproof

货物启运前，进口商需要一份简短的记录：这个 EORI 号码在结构上是否有效且已知，哪些 TARIC 编码可能适用于该产品，给定原产地的候选编码适用哪些欧盟措施，以及计入关税减免和目的地增值税后，一批小额货物可能需要多少成本。importproof 将这五项启运前核查整合到一个 MCP 接口中。

核查本身由托管服务执行。此软件包是本地部分：它根据从该服务捕获的定义返回工具列表，并将每次调用转发给该服务，原样返回收到的回复。这些答复是供申报人确认的依据，而非最终判定。候选分类仍是候选项；基于带日期快照获取的措施可能会返回复核提示，而非结论；成本数字则是根据已提供信息计算的估算，缺少的输入会标为缺失，不会靠猜测补齐。

此处的任何功能都不会提交海关申报、收取或支付关税、预订运输，也不会在任何地方提交收据。收据工具只会将调用者先前进行的核查汇总为一份签名记录，记录核查内容及时间。

工具

• validate_eori — 检查 EORI 号码。接受 eori（最多 20 个字符）。回复会分别说明结构有效性和权威来源的存在性核查结果；如果无法访问提供方，会如实报告，而不会将其视为核查失败。
• search_taric_codes — 为产品推荐候选 TARIC/CN 编码。接受 productDescription（最多 500 个字符），以及可选的 knownProperties，即由材质或预期用途等信息组成的简短属性字符串列表。候选项来自带日期的快照，并按证据排序。
• check_eu_import_measures — 列出适用于候选编码的欧盟层级措施。接受 code、originCountry 和 destinationCountry（ISO alpha-2 格式），以及可选的 date、goodsValueEur 和 itemCount。涵盖带日期快照中的第三国关税、优惠、禁止与限制措施，以及监督措施。
• estimate_low_value_import_cost — 估算内在价值不超过 150 EUR 的一批货物的到岸成本。接受 destinationCountry、currency 和 items（每个商品都需要 intrinsicValue，并可选填 taricCandidate），以及可选的 originCountry、用于选择关税制度的 asOfDate、iossUsed 和 destinationVatRatePercent。
• prepare_import_preflight_receipt — 将先前的核查汇总为一份签名收据。需要 bundle（待证明的启运前核查结果）和 createdAt（汇总内容的 ISO 时间戳）。收据证明的是核查情况，而非合规或清关结果。

对于前四个工具，捕获的架构未提供必填字段列表；只有收据工具要求提供 bundle 和 createdAt 参数。

配置

• EU_IMPORT_MCP_URL（可选）— 替换上游端点；默认值为 https://import.mcp.jithox.com/mcp。此覆盖钩子是本次重建的标注式还原。
• EU_IMPORT_API_KEY（可选）— 设置后，每个上游请求都会包含 Authorization: Bearer <value> 标头，其中携带调用者的密钥；未设置时，不会发送密钥标头。标头名称遵循原始服务的注册记录。该记录未指定软件包的环境变量名称，因此环境变量名称、Bearer 格式和转发行为均为标注式还原；捕获原始接口时未使用密钥。

调用流程

客户端发起的第一个调用会按顺序通过三个 JSON-RPC POST 请求建立会话：先发送 initialize，其中包含协议版本 2025-03-26 和客户端名称 importproof；然后发送 notifications/initialized 通知；最后发送 tools/call，并原样传递调用方的参数。如果 initialize 响应设置了 Mcp-Session-Id 标头，后续请求会携带该值，并在之后复用此会话。纯 JSON 响应和服务器发送事件格式的响应都能识别。

成功的响应会原样返回，包括上游自身设置的任何错误标志。无法完成的调用——包括上游 JSON-RPC 错误、非成功的 HTTP 状态码、无法读取为 JSON-RPC 的响应正文，或传输失败——会转换为错误结果，其文本以 importproof error: 开头（此措辞是本次重建中添加的标记）。

CLI

每个工具也可以作为子命令使用，其唯一参数为 JSON 对象字符串：

npx @reneturcios/importproof validate_eori '{"eori":"BE0123456749"}'
npx @reneturcios/importproof search_taric_codes '{"productDescription":"cotton t-shirt"}'
npx @reneturcios/importproof --version

退出码分别为：调用成功时为 0，结果为错误时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/importproof mcp

MCP 客户端配置：

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

Docker

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

不带参数时，容器会通过 stdio 启动 MCP 服务；带有其他任意参数时，则交由 CLI 处理。

开发

npm install
npm run build
npm test
npm run dev

测试会模拟上游 JSON-RPC 服务，因此整个测试套件不会发起实际网络请求。

许可证

MIT — 参见 LICENSE。