MCP-Server für Comexstat-API

Dieses Projekt implementiert einen MCP-Server (Model Context Protocol) für die Comexstat-API, wodurch KI-Modelle wie Claude direkt mit den brasilianischen Außenhandelsdaten interagieren können.

Überblick

Der MCP Comexstat-Server bietet Tools zum Abfragen brasilianischer Export- und Importstatistiken, darunter:

• Allgemeine Export- und Importdaten

• Daten der Gemeinden

• Historische Daten (1989-1996)

• Hilfstabellen mit Codes und Beschreibungen

Related MCP server: MCP Expr Lang

Merkmale

• Implementiert mit @modelcontextprotocol/sdk

• Tippen mit TypeScript

• Datenvalidierung mit Zod

• Unterstützung für die Kommunikation über stdin/stdout (MCP-Standard)

• Robuste API-Fehlerbehandlung und -Antworten

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

Schnelle Verwendung

# Execute o servidor MCP
npm start

Verfügbare Tools

Der MCP-Server bietet die folgenden Tools:

Allgemeine Daten

• getLastUpdate() – Ruft das Datum ab, an dem die Daten zuletzt aktualisiert wurden

• getAvailableYears() - Listet die für die Abfrage verfügbaren Jahre auf

• getAvailableFilters() - Listet verfügbare Filter auf

• getFilterValues(filter, language?) – Ruft Werte für einen bestimmten Filter ab

• getAvailableFields() - Listet die für die Detaillierung verfügbaren Felder auf

• getAvailableMetrics() - Listet verfügbare Metriken auf

• queryData(options) – Führt detaillierte Abfragen mit den folgenden Parametern aus:

  • flow : „Export“ | "Import"

  • period : {von: "JJJJ-MM", bis: "JJJJ-MM"}

  • monthDetail : Boolesch

  • filters : Array von Filtern (optional)

  • details : Array von Feldern zur Detaillierung

  • metrics : Array von Metriken

  • language : Zeichenfolge (optional, Standard: „pt“)

Daten der Gemeinden

• queryMunicipalitiesData(options) - Abfragedaten mit Schwerpunkt auf Gemeinden

Historische Daten

• queryHistoricalData(options) – Historische Daten abfragen (1989-1996)

Hilfstabellen

• getStates() - Listet brasilianische Bundesstaaten auf

• getStateDetails(ufId) – Details eines bestimmten Staates

• getCities() - Liste der Städte

• getCityDetails(cityId) – Details einer bestimmten Stadt

• getCountries(search?) - Länder auflisten

• getCountryDetails(countryId) – Details eines bestimmten Landes

• getEconomicBlocks(options?) – Listet Wirtschaftsblöcke auf

• getHarmonizedSystem(options?) – Harmonisiertes System (HS)

• getNBM(options?) - Brasilianische Warennomenklatur

• getNBMDetails(coNbm) – Details zu einem bestimmten NBM-Code

Anwendungsbeispiel

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

Integration mit Claude

So verwenden Sie den MCP-Server mit Claude Desktop:

1. Fügen Sie die Konfiguration zur Datei claude_desktop_config.json hinzu:

   {
     "mcpServers": {
       "comexstat": {
         "command": "node",
         "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"]
       }
     }
   }

2. Verwenden Sie auf Claude Desktop den folgenden Befehl:

   /mcp comexstat

Entwicklung

# Executar em modo de desenvolvimento
npm run dev

# Executar testes
npm test

# Verificar cobertura de testes
npm test -- --coverage

Lizenz

MIT