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

発達

ライセンス

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