What can you do with this server?

The **MCP Server for API Comexstat** provides access to Brazilian foreign trade statistics and related auxiliary data. With this server, you can: * **Query Trade Data**: Retrieve export/import statistics with detailed filters, fields, and metrics * **Access Municipal Data**: Get trade information specific to Brazilian municipalities * **Examine Historical Records**: View historical trade data from 1989-1996 * **Check Update Status**: Get the date of the last data update * **Retrieve Auxiliary Tables**: Access lists and details for states, cities, countries, economic blocks, and trade codes (Harmonized System, NBM) * **Perform Custom Queries**: Create detailed queries with various parameters including flow type, period, filters, and metrics * **List Available Parameters**: View available years, filters, fields, and metrics for constructing queries

The MCP Server for API Comexstat provides access to Brazilian foreign trade statistics and related auxiliary data. With this server, you can:

Query Trade Data: Retrieve export/import statistics with detailed filters, fields, and metrics
Access Municipal Data: Get trade information specific to Brazilian municipalities
Examine Historical Records: View historical trade data from 1989-1996
Check Update Status: Get the date of the last data update
Retrieve Auxiliary Tables: Access lists and details for states, cities, countries, economic blocks, and trade codes (Harmonized System, NBM)
Perform Custom Queries: Create detailed queries with various parameters including flow type, period, filters, and metrics
List Available Parameters: View available years, filters, fields, and metrics for constructing queries

MCP Server para API Comexstat

Este projeto implementa um servidor MCP (Model Context Protocol) para a API Comexstat, permitindo que modelos de IA como Claude interajam diretamente com os dados de comércio exterior do Brasil.

Visão Geral

O servidor MCP Comexstat fornece ferramentas para consultar estatísticas de exportação e importação brasileiras, incluindo:

Dados gerais de exportação e importação
Dados por municípios
Dados históricos (1989-1996)
Tabelas auxiliares com códigos e descrições

Related MCP server: MCP Expr Lang

Características

Implementado usando @modelcontextprotocol/sdk
Tipagem com TypeScript
Validação de dados com Zod
Suporte para comunicação via stdin/stdout (padrão MCP)
Tratamento robusto de erros e respostas da API

Instalação

Installing via Smithery

To install Comexstat Data Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @luizzzvictor/mcp-comexstat --client claude

Manual Installation

# 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

Uso Rápido

# Execute o servidor MCP npm start

Ferramentas Disponíveis

O servidor MCP fornece as seguintes ferramentas:

Dados Gerais

getLastUpdate() - Obtém a data da última atualização dos dados
getAvailableYears() - Lista os anos disponíveis para consulta
getAvailableFilters() - Lista os filtros disponíveis
getFilterValues(filter, language?) - Obtém valores para um filtro específico
getAvailableFields() - Lista os campos disponíveis para detalhamento
getAvailableMetrics() - Lista as métricas disponíveis
queryData(options) - Realiza consultas detalhadas com os seguintes parâmetros:
- flow: "export" | "import"
- period: { from: "YYYY-MM", to: "YYYY-MM" }
- monthDetail: boolean
- filters: Array de filtros (opcional)
- details: Array de campos para detalhamento
- metrics: Array de métricas
- language: string (opcional, default: "pt")

Dados por Municípios

queryMunicipalitiesData(options) - Consulta dados com foco em municípios

Dados Históricos

queryHistoricalData(options) - Consulta dados históricos (1989-1996)

Tabelas Auxiliares

getStates() - Lista estados brasileiros
getStateDetails(ufId) - Detalhes de um estado específico
getCities() - Lista municípios
getCityDetails(cityId) - Detalhes de um município específico
getCountries(search?) - Lista países
getCountryDetails(countryId) - Detalhes de um país específico
getEconomicBlocks(options?) - Lista blocos econômicos
getHarmonizedSystem(options?) - Sistema Harmonizado (SH)
getNBM(options?) - Nomenclatura Brasileira de Mercadorias
getNBMDetails(coNbm) - Detalhes de um código NBM específico

Exemplo de Uso

// 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"], });

Integração com Claude

Para usar o servidor MCP com Claude Desktop:

Adicione a configuração ao arquivo claude_desktop_config.json:
{ "mcpServers": { "comexstat": { "command": "node", "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"] } } }
No Claude Desktop, use o comando:
/mcp comexstat

Desenvolvimento

# Executar em modo de desenvolvimento npm run dev # Executar testes npm test # Verificar cobertura de testes npm test -- --coverage

Licença

MIT

mcp-comexstat