mcp-comexstat

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