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

Разработка

Лицензия

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