Skip to main content
Glama
mcp-comexstat

mcp-comexstat

by luizzzvictor

MCP-сервер для API Comexstat

В этом проекте реализован сервер MCP (Model Context Protocol) для API Comexstat, позволяющий моделям ИИ, таким как Claude, напрямую взаимодействовать с данными по внешней торговле Бразилии.

Обзор

Сервер 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 : { с: "ГГГГ-ММ", по: "ГГГГ-ММ" }

    • 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?) - Гармонизированная система (ГС)

  • 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"],
});

Интеграция с Клодом

Чтобы использовать сервер MCP с Claude Desktop:

  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.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    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