mcp-comex-brasil

巴西外贸数据 MCP 服务器 — 响应中已修正数据集中的陷阱。

四个不撒谎的工具，而不是四十个不知情的工具。

这个服务器解决的问题

一个仅暴露数据集的 MCP 服务器，交付给代理的是一个通往错误数字的干净 API。管道不知道这个字段在撒谎。

Comex Stat — 巴西官方外贸数据库，由 Secretaria de Comércio Exterior / Receita Federal 发布 — 有一个任何文档都没有警告的缺陷：

按 AÉREA 过滤运输方式字段，返回 2026 年（1–7 月）来自中国的进口 1.396 亿公斤。将这些相同记录与 清关点 交叉比对，只有 3400 万公斤（24%）经过机场。其余 8970 万公斤在 海运港口 清关，是硫酸铵和磷酸盐肥料——不会飞的货物，运费 US$0.29/kg。

不修正的话：空运重量虚增 4.1 倍，每公斤运费被低估 70%。 这个错误是无声的：查询中没有任何迹象。

这个服务器应用修正，并返回说明为什么需要修正的证据。

Related MCP server: mcp-comtrade

两大保证

1. 每个响应都包含适用于该查询的已知缺陷，并附有实测证据和验证来源。

2. 关键修正已应用在结果中，而不仅仅是发出警告。 air 渠道已经表示“在机场清关的空运”。被污染的数据块仍可作为 air_declared_at_port 查询——这是故意的，方便想要检查的人。

数据集拥有而已发布摘要丢弃的内容

进口文件带有 VL_FRETE 和 VL_SEGURO — 向海关申报的运费和保险费。这是公开可用的、对实际成本的最佳系统性度量，却几乎没有人使用它。

中国 → 巴西，2026 年 1–7 月，已修正：

空运每公斤成本高出 76 倍，而每美元货物仅高出 1.65 倍。这个通道的运输方式划分不是运费决策——而是价值密度决策。

安装

需要 Node ≥ 22.5（使用内置 SQLite — 零原生依赖，不需要 node-gyp）。

git clone <repo> && cd mcp-comex-brasil
npm install && npm run build
npm run db:build -- --years 2025,2026        # baixa da fonte oficial e monta o SQLite

db:build 直接从 balanca.economia.gov.br 获取文件。本包不重新分发任何数据 — 数据库在您自己的机器上构建，始终从源头获取的新鲜数据。

有用的选项：

npm run db:build -- --years 2026 --countries 160        # só China, base pequena e rápida
npm run db:build -- --years 2024,2025,2026 --flows import,export

在 MCP 客户端中的配置

{
  "mcpServers": {
    "comex": {
      "command": "node",
      "args": ["--experimental-sqlite", "/caminho/para/mcp-comex-brasil/dist/index.js"],
      "env": { "COMEX_LANG": "pt" }
    }
  }
}

COMEX_LANG 接受 pt（默认）或 en。COMEX_DB 覆盖数据库路径。

四个工具

伴随响应的数据缺陷说明

关于 simplified_regime_absent：存在 POSTAL 和 COURIER 的运输方式代码，但它们是空的（2026 年全年中国只有 13 条记录和 72 公斤，而报告的国际包裹约为 1.8 亿件）。低价值货物通过简化制度处理，不计入贸易统计。正式统计与包裹量是两个互不相交的宇宙 — 不要相加，不要进行算术比较。

验证

聚合结果通过交叉实现进行了验证：同一数据切片，分别由对原始 CSV 执行的一次 awk 处理和本服务器的 SQL 视图处理，产生的数字直到最后一位都完全相同（349.250 条记录、7 个渠道、运费和重量值）。

npm test     # 12 testes da lógica de classificação e do registro de caveats

许可证与数据来源

MIT。数据：Comex Stat，Secretaria de Comércio Exterior / Receita Federal do Brasil（balanca.economia.gov.br）— 公共来源，在构建数据库时获取。

作者：Luis Delfin

英文

用于巴西外贸数据的 MCP 服务器 — 响应中已修正数据集的陷阱。

四个不撒谎的工具，而不是四十个不知情的工具。

问题

一个仅仅暴露数据集的 MCP 服务器，交付给代理的是一个通往错误数字的干净 API。管道不知道这个字段在撒谎。

巴西官方贸易数据集（Comex Stat，由 Foreign Trade Secretariat / Federal Revenue Service 发布）有一个任何文档都没有警告的缺陷：

按 AIR 过滤运输方式字段，返回 2026 年 1–7 月来自中国的进口 1.396 亿公斤。将这些相同记录与它们的 清关点 交叉比对，只有 3400 万（24%）经过机场。其余 8970 万在 海港 清关，成分是硫酸铵和磷酸盐肥料——不会飞的货物，运费 US$0.29/kg。

不修正的话：空运重量虚增 4.1 倍，每公斤运费被低估 70%。 这个错误是无声的——查询中没有任何标记。

这个服务器应用修正，并返回说明为什么需要修正的证据。

两大保证

1. 每个响应都包含适用于该查询的已知缺陷，并附有实测证据和验证来源。

2. 关键修正已应用，而不仅仅是发出警告。 air 渠道已经表示“在机场清关的空运方式”。被污染的数据块仍可作为 air_declared_at_port 查询——这是故意的，方便任何想要检查它的人。

数据集拥有而已发布的摘要丢弃的内容

进口文件带有 VL_FRETE 和 VL_SEGURO — 向海关申报的运费和保险费。这是公开可用的、对实际成本的最佳系统性度量，却几乎无人使用。

中国 → 巴西，2026 年 1–7 月，已修正：

空运每公斤成本高出 76 倍，而每美元货物仅高出 1.65 倍。这个通道的运输方式划分不是运费决策——而是价值密度决策。

安装

需要 Node ≥ 22.5（使用内置 SQLite — 零原生依赖，不需要 node-gyp）。

npm install && npm run build
npm run db:build -- --years 2025,2026        # fetches from the official source, builds SQLite

db:build 直接从 balanca.economia.gov.br 获取文件。本包不重新分发任何数据 — 数据库在您的机器上构建，始终从源头获取的新鲜数据。

四个工具

验证

聚合结果通过交叉实现进行了验证：同一数据切片，分别由对原始 CSV 执行的一次 awk 处理和本服务器的 SQL 视图处理，产生的数字直到最后一位都完全相同（349,250 条记录、7 个渠道、运费和重量值）。

npm test     # 12 tests covering the classification logic and the caveat registry

MIT。数据：Comex Stat，Brazilian Foreign Trade Secretariat / Federal Revenue Service。作者：Luis Delfin