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

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

Schnelle Verwendung

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

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

Lizenz

MIT