Comexstat API 用の MCP サーバー

このプロジェクトは、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 サーバーを使用するには:

1. claude_desktop_config.jsonファイルに構成を追加します。

   {
     "mcpServers": {
       "comexstat": {
         "command": "node",
         "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"]
       }
     }
   }

2. Claude Desktop では、次のコマンドを使用します。

   /mcp comexstat

発達

# Executar em modo de desenvolvimento
npm run dev

# Executar testes
npm test

# Verificar cobertura de testes
npm test -- --coverage

ライセンス

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