TradeCheck Local Invoice Review

TradeCheck MCP · 0.2.0 beta

面向进口商和采购团队的本地工具，用于审核发票。它会比对一份采购订单、一张供应商发票以及提供的历史发票记录，然后准备一封未发送的供应商澄清邮件。它是通过 MCP 提供的确定性审核引擎，并附带引导式 Agent 提示词。它不是托管模型、OCR 服务、ERP 集成或自主付款 Agent。

试用浏览器工作台：https://rfqdesk.agiscorecard.com/agent

从这里开始

1. 安装 Node.js 22 或更高版本。从网站下载并解压 beta 压缩包。
2. 在解压后的 tradecheck-mcp 目录中打开终端。安装固定版本的依赖项，并测试打包后的构建：

npm ci --ignore-scripts --no-audit --no-fund
npm test
npm run demo

此演示通过 stdio 连接真实的 MCP 客户端，加载一份虚构订单，并发现价格差异为 EUR 44.00，累计供货数量为 320，对应订购数量 300。这些都是虚构的差异，并非追回的款项。

3. 在兼容 MCP 的桌面助手中注册此服务。对于 Claude Code，请替换为实际的绝对路径：

claude mcp add tradecheck -- node /absolute/path/tradecheck-mcp/dist/server.js

在 Claude Code 中运行 /mcp，检查是否出现四个 TradeCheck 工具。对于 Cursor，请将此条目添加到其 MCP 配置中：

{"mcpServers":{"tradecheck":{"command":"node","args":["/absolute/path/tradecheck-mcp/dist/server.js"]}}}

在 Windows 上使用绝对路径，例如 C:/Users/you/tradecheck-mcp/dist/server.js。如果桌面应用找不到 node，请使用其可执行文件的绝对路径。此服务使用本地 stdio，并非远程 URL。

4. 向助手提问：“使用 TradeCheck 的 review_supplier_invoice 提示词。先展示虚构示例。然后帮我准备 PO 和发票，让我确认提取的字段，并生成双向审核结果以及一封未发送的供应商澄清邮件。”

如果宿主没有显示提示词，请粘贴 AGENT-WORKFLOW.md。宿主能否读取 PDF 或图像附件取决于该宿主；此软件包不执行 OCR。尚未完成对提取质量的模型评估。已测试真实 SDK 客户端的往返调用；本版本尚未逐一测试所列的桌面宿主。

可用工具

工具	输入	输出
tradecheck_import_tables	PO/发票抬头元数据、CSV/TSV 文本和明确的从零开始列映射	未审核的结构化数据，历史记录未知
tradecheck_example	{}	稳定的虚构输入和契约
tradecheck_reconcile	{data, offset?:0, limit?:20}	摘要、一页发现项、发现项总数、下一偏移量
tradecheck_supplier_draft	{data, language?:"en"}	未发送的主题/正文，最多包含 20 项例外/缺失项

阅读 tradecheck://contract 了解适用范围。请使用示例 JSON，而不要自行编造字段。十进制数必须使用字符串。未知的必需金额必须先确认；留空不等于零。如果较早的发票可能缺失，请保留 history_status:"unknown"。只有在人员根据原始文档核对字段后，才能设置 extraction_reviewed:true。

检查内容

精确核对 PO/供应商标识符、币种一致性、明确的 PO 行映射、SKU 和单位、单价变化、累计供货数量、重复的供货 ID，以及行项/小计/抬头的算术关系。合法的部分开票仅作提示信息。所有计算均使用整数十进制刻度，并按每行四舍五入（半入）。货币总额保留两位小数，JPY 则取整数。数量最多支持三位小数，单价最多支持四位小数。

支持的币种：USD、EUR、GBP、CAD、AUD、CNY、SGD、CHF、JPY。不支持外币兑换或单位换算。SKU 匹配并不足以推断 PO 行。输入最多支持 100 条 PO/当前行、20 张较早的发票和 1,000 条较早的发票行。报告最多分页显示 25 条发现项；每条发现项最多包含六个来源定位符，并明确提供 refs_omitted 计数。浏览器/完整 JSON 报告会保留所有提供的引用。

影响结果的限制

• 双向匹配无法验证交付、收货、质量、合同验收、海关、制裁、银行信息或付款资格。
• 来源引用和完整性均由调用方声明，不构成加密证据或独立的文档验证。
• 不支持负数、贷项通知单、押金、折扣、税务验证或其他舍入约定。这类文档需要采用不同的工作流。
• 价格差异是所有可比匹配行的有符号总额，不是多付款、节省金额或追回金额。
• 异常列表为空仅表示所提供且受支持的数据中没有异常。payment_authorized 始终为 false。
• 中文草稿使用中文引言，并保留英文诊断行；助手可以翻译这些内容，但须保留数值和引用。

隐私与运行

此 MCP 不会发起网络请求、读取任何文档路径、存储任何文档，也不收集遥测数据。它只处理调用方提供的值。你的 AI 助手可能会将附件和工具数据发送给其模型提供商；相关费用和数据条款仍然适用。公开的浏览器演示在本地运行。可选的网站事件不包含文档数据。

未启用任何付费服务。拟议中的每月 29 欧元团队工作区目前仅处于研究阶段；保存历史记录、供应商映射和批次管理功能均不可用。Beta 使用受 LICENSE.txt 约束；依赖项许可证见 THIRD-PARTY-NOTICES.txt。

开发与验证

npm run build
npm test
npm run demo
npm run package

打包命令会暂存明确列出的允许文件，包括经过测试的构建产物、测试夹具、文档、源文件和固定版本的依赖清单。它会排除仓库内容、凭据、node_modules 和买方文档。请使用 SHA256SUMS 验证下载内容。

协议和十进制合同测试不用于衡量大模型、OCR 或商业准确性。如需了解其中包含的独立只读协议场景，请参阅 EVALUATION.md。

v0.2 中的电子表格输入

粘贴包含表头的 CSV 或制表符分隔单元格。浏览器会预览五行和所有映射；最多导入 100 行数据。必须显式映射列，且不得重复使用列。文件名和物理行定位符会予以保留。每个表头中的金额、货币、供应商和订单 ID 均为必填项。本地化小数和数值公式会被拒绝；未知费用绝不会补填为零。历史记录初始状态为未知，extraction_reviewed 初始值为 false。对账前，请根据原始文档进行确认。MCP 通过 tradecheck_import_tables 接受相同的文本和从零开始的映射索引。

发布存档使用固定时间戳和明确列出的源文件允许清单。发布内容变更时，请更新软件包/下载版本。审计报告架构仍为版本 0.1.0；软件包版本 0.2.0 增加了输入准备功能，但不会改变报告语义。