Comexstat API 用の MCP サーバー

Name: mcp-comexstat
Author: luizzzvictor

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

概要

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

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

Related MCP server: MCP Expr Lang

特徴

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

インストール

# Clone o repositório git clone https://github.com/luizzzvictor/mcp-comexstat-easy.git cd mcp-comexstat-easy # Instale as dependências npm install # Compile o código TypeScript npm run build

クイック使用

# Execute o servidor MCP npm start

利用可能なツール

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コードの詳細

使用例

// Consultar exportações para os EUA em 2023 const result = await queryData({ flow: "export", period: { from: "2023-01", to: "2023-12" }, monthDetail: false, filters: [{ filter: "country", values: [105] }], details: ["country", "month"], metrics: ["metricFOB", "metricKG"], });

クロードとの統合

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

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