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

Name: mcp-comexstat
Author: luizzzvictor

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

Обзор

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