Skip to main content
Glama
mcp-comexstat

mcp-comexstat

by luizzzvictor

Comexstat API 用の MCP サーバー

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

概要

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

  • 一般的な輸出入データ

  • 市町村別データ

  • 履歴データ(1989~1996年)

  • コードと説明を含む補助表

Related MCP server: br-eli-mcp

特徴

  • @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

ライセンス

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

Available Tools

20 tools
getAuxiliaryTableD

Inputs: table (required), page, pageSize, search.

getAvailableFieldsD

Inputs: no named parameters.

getAvailableFiltersD

Inputs: no named parameters.

getAvailableMetricsD

Inputs: no named parameters.

getAvailableYearsD

Inputs: no named parameters.

getCitiesD

Inputs: no named parameters.

getCityDetailsD

Inputs: cityId (required).

getCountriesD

Inputs: search.

getCountryDetailsD

Inputs: countryId (required).

getEconomicBlocksD

Inputs: add, language, search.

getFilterValuesD

Inputs: filter (required), language.

getHarmonizedSystemD

Inputs: add, language, page, perPage.

getLastUpdateD

Inputs: no named parameters.

getNBMD

Inputs: add, language, page, perPage, +1 more.

getNBMDetailsD

Inputs: coNbm (required).

getStateDetailsD

Inputs: ufId (required).

getStatesD

Inputs: no named parameters.

queryDataD

Inputs: details (required), flow (required), metrics (required), monthDetail (required), +3 more.

queryHistoricalDataD

Inputs: details (required), flow (required), metrics (required), period (required), +3 more.

queryMunicipalitiesDataD

Inputs: details (required), flow (required), metrics (required), period (required), +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.9/5.0

    Scored across 20 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes targeting different data entities (countries, states, cities, NBM, etc.) or metadata (available fields, filters, metrics). However, some pairs like getCities/getMunicipalitiesData and getNBM/getNBMDetails have potential overlap that could cause confusion without descriptions to clarify their boundaries.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'get' or 'query' prefixes, using camelCase uniformly throughout. The naming is highly predictable and readable, with clear conventions for different types of operations (get for metadata/entities, query for data retrieval).

    Tool Count3/5

    With 20 tools, this is borderline heavy for a trade statistics server. While the domain appears broad (covering countries, states, cities, NBM codes, auxiliary tables, etc.), the count feels somewhat inflated with multiple similar metadata tools (getAvailableFields/Filters/Metrics/Years) that might be consolidated.

    Completeness4/5

    The tool set appears to provide comprehensive coverage for trade data exploration and retrieval, including metadata discovery, entity lookups, and data querying across different dimensions (current, historical, municipal). Minor gaps might exist in data modification capabilities, but for a read-only statistical service, the surface seems reasonably complete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      MCP Server do SEI Pro para o SEI (Sistema Eletrônico de Informações) via API REST mod-wssei v2 + scraper do frontend web (modo híbrido).
      100
      21
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for the Brazilian Chamber of Deputies open-data API, enabling search and retrieval of federal legislative bills and their status.
      15
      82 PyPI
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the Omie API to list products, consult clients, and create budgets
      MIT