mcp-comexstat
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:
Добавьте конфигурацию в файл
claude_desktop_config.json:{ "mcpServers": { "comexstat": { "command": "node", "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"] } } }На 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 toolsgetAuxiliaryTableD
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
Scored across 20 tools
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.
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).
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.
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
Related MCP Connectors
Brazil Comex Stat MCP — Brazilian foreign trade statistics from MDIC (Ministério do…
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Comtrade MCP — UN Comtrade API for international bilateral trade data
# MCP DadosBR Servidor MCP focado em dados públicos do Brasil. Oferece duas ferramentas simples e…
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP 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).10021MIT
- AlicenseAqualityBmaintenanceMCP server for the Brazilian Chamber of Deputies open-data API, enabling search and retrieval of federal legislative bills and their status.1582 PyPI2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server for the Omie API to list products, consult clients, and create budgetsMIT
- FlicenseNot gradedqualityDmaintenanceMCP server that provides access to UK trade data from the ONS Trade Data API, enabling queries for trade statistics, metadata, and raw data.-