Dokumentation

MCP-Server für Claude

Was ist MCP?

MCP (Model Context Protocol) ist ein Standard, der KI-Assistenten wie Claude ermöglicht, mit externen Tools und Datenquellen zu interagieren. Unser MCP-Server ermöglicht es Claude, Länder, Bundesländer, Städte und Postleitzahlen direkt in Gesprächen abzufragen.

Installation

Installieren Sie global über npm:

npm install -g @countrydataapi/mcp-server

Oder verwenden Sie es direkt mit npx (keine Installation erforderlich):

npx @countrydataapi/mcp-server

Konfiguration für Claude Desktop

Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "country-data-api": {
      "command": "npx",
      "args": ["@countrydataapi/mcp-server"],
      "env": {
        "COUNTRY_DATA_API_KEY": "ihr-api-schluessel-hier"
      }
    }
  }
}

Starten Sie nach dem Speichern der Konfiguration Claude Desktop neu.

Verfügbare Tools

Nach der Konfiguration hat Claude Zugriff auf folgende Tools:

Länder

Tool Beschreibung
get_countries_all Alle Länder abrufen
get_country_by_name Land nach Name abrufen
get_country_by_code Land nach ISO-Code abrufen (DE, DEU, 276)
get_countries_by_region Länder nach Region abrufen (Europa, Asien, etc.)
get_countries_by_currency Länder nach Währung abrufen (EUR, USD, etc.)
get_countries_by_language Länder nach Sprache abrufen (deu, eng, etc.)
get_countries_by_timezone Länder nach Zeitzone abrufen

Bundesländer

Tool Beschreibung
get_states_all Alle Bundesländer/Provinzen abrufen
get_states_by_country Bundesländer eines Landes abrufen
get_states_by_city Bundesländer mit einer bestimmten Stadt abrufen

Städte

Tool Beschreibung
get_cities_all Alle Städte abrufen
get_city Stadt nach Name abrufen
get_cities_by_country Städte eines Landes abrufen
get_cities_by_state Städte eines Bundeslandes abrufen

Postleitzahlen

Tool Beschreibung
get_zipcodes_by_country Postleitzahlen eines Landes abrufen
get_zipcodes_by_state Postleitzahlen eines Bundeslandes abrufen

Select (Optimiert - je 1 Token)

Tool Beschreibung
get_select_countries Leichtgewichtige Länderliste für Dropdown-Menüs
get_select_states Leichtgewichtige Bundesländerliste für Dropdown-Menüs
get_select_cities Leichtgewichtige Städteliste für Dropdown-Menüs

Status

Tool Beschreibung
get_api_status Verbleibende API-Tokens abrufen

Beispielgespräche

Nach der Konfiguration können Sie Claude Dinge fragen wie:

Länderinformationen abrufen

"Welche Länder gibt es in Europa?" "Erzähl mir über Deutschland" "Was ist die Hauptstadt von Frankreich?"

Bundesländer/Provinzen finden

"Welche Bundesländer gibt es in Deutschland?" "Liste die Provinzen von Kanada auf"

Städteanfragen

"Welche Städte gibt es in Bayern?" "Finde Städte in der Region Berlin"

Token-Verwaltung

"Wie viele API-Tokens habe ich noch?"

Allgemeine Parameter

Die meisten Tools akzeptieren diese optionalen Parameter:

Parameter Beschreibung
lang Antwortsprache: en, es, pt, fr, de, it
fields Kommagetrennte Liste der zurückzugebenden Felder
limitToken Maximale Tokens für diese Anfrage

Umgebungsvariablen

Variable Beschreibung Erforderlich
COUNTRY_DATA_API_KEY Ihr API-Schlüssel von countrydataapi.com Ja

Fehlerbehebung

Claude sieht die Tools nicht

  1. Stellen Sie sicher, dass die Konfigurationsdatei korrekt gespeichert wurde
  2. Starten Sie Claude Desktop vollständig neu
  3. Überprüfen Sie, ob Ihr API-Schlüssel gültig ist

Fehler: Ungültiger API-Schlüssel

Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist und noch Tokens vorhanden sind. Sie können Ihren Token-Saldo in Ihrem Konto-Dashboard überprüfen.

Tools sind langsam

Der MCP-Server verwendet dieselbe API wie direkte Anfragen. Wenn Abfragen langsam sind, versuchen Sie:

  • Spezifischere Abfragen zu verwenden (z.B. nach Land suchen statt alle)
  • Ergebnisse mit limitToken zu begrenzen
  • Die select-Endpunkte für Dropdown-Daten zu verwenden

Sicherheitshinweise

  • Ihr API-Schlüssel wird lokal in der Claude Desktop-Konfiguration gespeichert
  • Der MCP-Server kommuniziert nur mit der Country Data API
  • Keine Daten werden an Dritte gesendet

Links