mcp-comexstat

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

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

Обзор

Сервер MCP Comexstat предоставляет инструменты для запроса статистики экспорта и импорта Бразилии, включая:

• Общие данные по экспорту и импорту
• Данные по муниципалитетам
• Исторические данные (1989-1996)
• Вспомогательные таблицы с кодами и описаниями

Функции

• Реализовано с помощью @modelcontextprotocol/sdk
• Набор текста с помощью TypeScript
• Проверка данных с помощью Zod
• Поддержка связи через stdin/stdout (стандарт MCP)
• Надежная обработка ошибок API и ответы

Установка

Быстрое использование

Доступные инструменты

Сервер 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

Пример использования

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

Чтобы использовать сервер 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

Разработка

Лицензия

Массачусетский технологический институт