mcp-comex-brasil

ブラジルの対外貿易データ用MCPサーバー — データセットの落とし穴をレスポンス内で修正済み。

嘘をつかない4つのツール。何も知らない40個の代わりに。

このサーバーが解決する問題

データセットを公開するだけのMCPサーバーは、エージェントに誤った数値へのクリーンなAPIを渡してしまいます。配管は、そのフィールドが嘘をついていることを知りません。

Comex Stat — ブラジルの公式な対外貿易データベースで、外国貿易庁 / 連邦歳入庁が公開 — には、どのドキュメントも警告していない欠陥があります：

AÉREA で輸送手段フィールドをフィルタリングすると、2026年（1月〜7月）の中国からの輸入が1億3960万kg返ります。同じレコードを通関地とクロス参照すると、空港を経由したのはわずか3400万（24%）だけです。残りの8970万は海港で通関されており、硫酸アンモニウムとリン酸質肥料 — 飛ばない貨物で、運賃はUS$0,29/kgです。

未修正の場合：航空重量は4.1倍に膨らみ、1kgあたり運賃は70%過小評価されます。 このエラーは沈黙しています。クエリは何も示しません。

このサーバーはその修正を適用し、なぜ修正が必要かのエビデンスも併せて返します。

Related MCP server: mcp-comtrade

2つの保証

1. すべてのレスポンスに、そのクエリに該当する既知の欠陥を、測定されたエビデンスと検証の由来とともに含めます。

2. 重大な修正は、単に警告されるだけでなく、結果に適用されています。 air チャネルはすでに「空港で通関された航空便」を意味します。汚染されたブロックは、意図的に air_declared_at_port として照会可能なままにしています — 検査したい人のために。

公開された要約が捨てている、データセットに含まれるもの

輸入ファイルには VL_FRETE と VL_SEGURO — 税関に申告された運賃と保険 — が含まれています。これは公的に入手可能な、実現コストの最良の体系的指標であり、ほとんど誰も使っていません。

中国 → ブラジル、2026年1月〜7月、修正済み：

航空は1kgあたり76倍のコストで、商品1ドルあたりではわずか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 はデータベースのパスを上書きします。

4つのツール

レスポンスに付随するcaveats

simplified_regime_absent について：POSTAL と COURIER の輸送手段コードは存在しますが、空です（2026年通年の中国では13件・72kg。報告された国際小包は約1億8000万件）。低価値の荷物は簡易制度を通るため、貿易統計には入りません。正式な統計と小包量は交わらない世界です — 足してはいけませんし、算術的に比較してもいけません。

検証

集計値は相互実装によって検証されています：同じ範囲を、生のCSVに対する1回の awk パスと、このサーバーのSQLビューで処理すると、最後の桁まで同一の数値が得られます（349.250レコード、7チャネル、運賃と重量の値）。

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

ライセンスとソース

MIT。データ：Comex Stat、ブラジル外国貿易庁 / 連邦歳入庁（balanca.economia.gov.br）— 公開ソースで、ベース構築時に参照。

著者：Luis Delfin

英語

ブラジルの対外貿易データ用MCPサーバー — データセットの落とし穴をレスポンス内で修正済み。

嘘をつかない4つのツール。何も知らない40個の代わりに。

問題

データセットを公開するだけのMCPサーバーは、エージェントに間違った数値へのクリーンなAPIを渡します。配管は、そのフィールドが嘘をついていることを知りません。

ブラジルの公式貿易データセット（Comex Stat。外国貿易庁 / 連邦歳入庁が公開）には、どのドキュメントも警告していない欠陥があります：

AIR で輸送手段フィールドをフィルタリングすると、2026年1月〜7月の中国からの輸入は1億3960万kgになります。同じレコードを通関地とクロス参照すると、空港を通過したのはわずか3400万（24%）だけです。残りの8970万は海港で通関され、硫酸アンモニウムとリン酸質肥料 — 飛ばない貨物で、運賃はUS$0.29/kgです。

未修正の場合：航空重量は4.1倍過大計上、1kgあたり運賃は70%過小計上。 このエラーは沈黙しています — クエリは何もフラグを立てません。

このサーバーは修正を適用し、なぜ修正が必要かのエビデンスも返します。

2つの保証

1. すべてのレスポンスに、そのクエリに該当する既知の欠陥を、測定されたエビデンスと検証の由来とともに含めます。

2. 重大な修正は、単に警告されるだけでなく、適用されています。 air チャネルはすでに「空港で通関された航空モード」を意味します。汚染されたブロックは、意図的に air_declared_at_port として照会可能なまま残されています — 検査したい人のために。

公開済みサマリーが捨てている、データセットに含まれるもの

輸入ファイルには VL_FRETE と VL_SEGURO — 税関に申告されたままの運賃と保険 — が含まれています。これは公的に入手可能な実現コストの最良の体系的指標ですが、ほとんど誰も使っていません。

中国 → ブラジル、2026年1月〜7月、修正済み：

航空は1kgあたり76倍のコストで、商品1ドルあたりではわずか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 から直接ファイルを取得します。このパッケージはデータを再配布しません — データベースはソースから常に新しい状態で、お使いのマシン上に構築されます。

4つのツール

検証

集計値は相互実装によって検証されています：同じ範囲を、生のCSVに対する1回の awk パスと、このサーバーのSQLビューで処理すると、最後の桁まで同一の数値が得られます（349,250レコード、7チャネル、運賃と重量の値）。

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

MIT。データ：Comex Stat、ブラジル外国貿易庁 / 連邦歳入庁。著者：Luis Delfin