mcp-comexstat

Comexstat API 用の MCP サーバー

このプロジェクトは、Comexstat API 用の MCP (モデル コンテキスト プロトコル) サーバーを実装し、Claude のような AI モデルがブラジルの対外貿易データと直接やり取りできるようにします。

概要

MCP Comexstat サーバーは、次のようなブラジルの輸出入統計を照会するためのツールを提供します。

• 一般的な輸出入データ
• 市町村別データ
• 履歴データ（1989～1996年）
• コードと説明を含む補助表

特徴

• @modelcontextprotocol/sdkを使用して実装
• TypeScriptによる型付け
• Zodによるデータ検証
• stdin/stdout 経由の通信のサポート (MCP 標準)
• 堅牢なAPIエラー処理と応答

インストール

クイック使用

利用可能なツール

MCP サーバーは次のツールを提供します。

一般データ

• getLastUpdate() - データが最後に更新された日付を取得します
• getAvailableYears() - クエリに利用可能な年をリストします
• getAvailableFilters() - 利用可能なフィルターを一覧表示します
• getFilterValues(filter, language?) - 特定のフィルターの値を取得します
• getAvailableFields() - 詳細表示に使用できるフィールドを一覧表示します
• getAvailableMetrics() - 利用可能なメトリックを一覧表示します
• queryData(options) - 次のパラメータを使用して詳細なクエリを実行します。
  • flow ：「エクスポート」| "輸入"
  • period : { 開始: "YYYY-MM", 終了: "YYYY-MM" }
  • monthDetail : ブール値
  • filters : フィルターの配列（オプション）
  • details : 詳細を示すフィールドの配列
  • metrics : メトリクスの配列
  • language : 文字列 (オプション、デフォルト: "pt")

市町村別データ

• queryMunicipalitiesData(options) - 市町村に焦点を当てたクエリデータ

履歴データ

• queryHistoricalData(options) - 履歴データのクエリ (1989-1996)

補助表

• getStates() - ブラジルの州を一覧表示する
• getStateDetails(ufId) - 特定の状態の詳細
• getCities() - 都市のリスト
• getCityDetails(cityId) - 特定の都市の詳細
• getCountries(search?) - 国を一覧表示する
• getCountryDetails(countryId) - 特定の国の詳細
• getEconomicBlocks(options?) - 経済ブロックの一覧を取得する
• getHarmonizedSystem(options?) - 調和システム (HS)
• getNBM(options?) - ブラジル商品命名法
• getNBMDetails(coNbm) - 特定のNBMコードの詳細

使用例

クロードとの統合

Claude Desktop で MCP サーバーを使用するには:

1. claude_desktop_config.jsonファイルに構成を追加します。
   { "mcpServers": { "comexstat": { "command": "node", "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"] } } }
2. Claude Desktop では、次のコマンドを使用します。
   /mcp comexstat

発達

ライセンス

マサチューセッツ工科大学