mcp-comexstat

Servidor MCP para la API de Comexstat

Este proyecto implementa un servidor MCP (Model Context Protocol) para la API de Comexstat, permitiendo que modelos de IA como Claude interactúen directamente con los datos de comercio exterior de Brasil.

Descripción general

El servidor Comexstat del MCP ofrece herramientas para consultar las estadísticas de exportación e importación brasileñas, entre ellas:

• Datos generales de exportación e importación
• Datos por municipios
• Datos históricos (1989-1996)
• Tablas auxiliares con códigos y descripciones

Características

• Implementado usando @modelcontextprotocol/sdk
• Escribir con TypeScript
• Validación de datos con Zod
• Soporte para comunicación vía stdin/stdout (estándar MCP)
• Manejo robusto de errores y respuestas de API

Instalación

Uso rápido

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas:

Datos generales

• getLastUpdate() - Obtiene la fecha en la que se actualizaron los datos por última vez
• getAvailableYears() - Enumera los años disponibles para la consulta
• getAvailableFilters() - Enumera los filtros disponibles
• getFilterValues(filter, language?) - Obtiene valores para un filtro específico
• getAvailableFields() - Enumera los campos disponibles para detallar
• getAvailableMetrics() - Enumera las métricas disponibles
• queryData(options) - Realiza consultas detalladas con los siguientes parámetros:
  • flow : "exportar" | "importar"
  • period : { desde: "AAAA-MM", hasta: "AAAA-MM" }
  • monthDetail : booleano
  • filters : Matriz de filtros (opcional)
  • details : Matriz de campos para detallar
  • metrics : Matriz de métricas
  • language : cadena (opcional, predeterminado: "pt")

Datos por municipios

• queryMunicipalitiesData(options) - Consulta datos centrados en los municipios

Datos históricos

• queryHistoricalData(options) - Consultar datos históricos (1989-1996)

Mesas Auxiliares

• getStates() - Lista de estados brasileños
• getStateDetails(ufId) : detalles de un estado específico
• getCities() - Lista de ciudades
• getCityDetails(cityId) - Detalles de una ciudad específica
• getCountries(search?) - Lista de países
• getCountryDetails(countryId) - Detalles de un país específico
• getEconomicBlocks(options?) - Lista de bloques económicos
• getHarmonizedSystem(options?) - Sistema Armonizado (SA)
• getNBM(options?) - Nomenclatura Brasileña de Mercancías
• getNBMDetails(coNbm) : detalles de un código NBM específico

Ejemplo de uso

Integración con Claude

Para utilizar el servidor MCP con Claude Desktop:

1. Agregue la configuración al archivo claude_desktop_config.json :
   { "mcpServers": { "comexstat": { "command": "node", "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"] } } }
2. En Claude Desktop, utilice el comando:
   /mcp comexstat

Desarrollo

Licencia

Instituto Tecnológico de Massachusetts (MIT)