IPGeolocation.io MCP Server

Offizieller MCP-Server für IPGeolocation.io. Enthält 16 MCP-Tools: IP-Geolocation, Bedrohungs-/VPN-/Proxy-Erkennung, Zeitzonen-Abfragen und -Konvertierungen, Daten zu Sonnenaufgang/-untergang/Mond, ASN-Details, Missbrauchskontakte und User-Agent-Parsing. Sieben Tools funktionieren mit dem kostenlosen Plan (1.000 Credits/Tag). Kostenpflichtige Pläne schalten alle 16 sowie Bulk-Endpunkte frei (bis zu 1.000 Elemente pro Aufruf).

Funktioniert mit Claude Desktop, Cursor, Windsurf, VS Code, Codex, Cline, Glama und jedem anderen MCP-Client.

Schnellstart

1. Erstellen Sie einen kostenlosen IPGeolocation API-Schlüssel

2. Cursor-Benutzer können mit einem Klick installieren:

   

3. Fügen Sie dies Ihrer MCP-Client-Konfiguration hinzu (siehe Install by Client unten für den genauen Pfad der Konfigurationsdatei für Ihren Client):

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. Starten Sie Ihren Client neu.

5. Testen Sie es: Fragen Sie "Wo befindet sich 8.8.8.8?"

Inhaltsverzeichnis

• Schnellstart

• Installation nach Client

• Überprüfung der Funktion

• Tools nach Plan

• Tool-Referenz

• Prompt-Beispiele

• Beispielantworten und Tool-Ausgabe

• Fehlercodes

• Funktionsweise

• Caching

• Umgebungsvariablen

• Aus Quellcode erstellen

• Docker

• Testen

• Fehlerbehebung

• Preise

• Links

• Lizenz

• Datenschutzrichtlinie

Installation nach Client

Anforderungen

• Node.js 18 oder neuer

• npx in Ihrem Terminal verfügbar

• Ein IPGeolocation.io API-Schlüssel für die meisten Tools

get_my_ip funktioniert ohne API-Schlüssel. Alles andere erfordert einen.

Registrieren Sie sich für einen kostenlosen IPGeolocation API-Schlüssel

Codex CLI

codex mcp add ipgeolocation --env IPGEOLOCATION_API_KEY=<YOUR_API_KEY> -- npx -y ipgeolocation-io-mcp
codex mcp list

Starten Sie eine neue Codex-Sitzung, nachdem Sie den Server hinzugefügt haben.

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu. Wir liefern auch manifest.json für Clients, die MCP-Bundles unterstützen.

Cline

Öffnen Sie das MCP Servers-Panel > Configure > Advanced MCP Settings. Fügen Sie dies zu cline_mcp_settings.json hinzu:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Starten Sie Cline nach dem Speichern neu.

Cursor

Ein-Klick-Installation:

Oder manuell zu .cursor/mcp.json hinzufügen:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Starten Sie Cursor nach dem Speichern neu.

Windsurf

Fügen Sie dies zu ~/.codeium/windsurf/mcp_config.json hinzu:

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Starten Sie Windsurf nach dem Speichern neu.

VS Code / GitHub Copilot

Fügen Sie dies zu Ihrer VS Code settings.json hinzu:

{
  "mcp": {
    "servers": {
      "ipgeolocation": {
        "command": "npx",
        "args": ["-y", "ipgeolocation-io-mcp"],
        "env": {
          "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

Starten Sie VS Code nach dem Speichern neu.

Glama

Sie können den Server direkt auf Glama ausprobieren. Nur IPGEOLOCATION_API_KEY ist erforderlich. Lassen Sie andere Umgebungsvariablen leer, es sei denn, Sie möchten Cache, Timeout oder Ausgabelimits ändern.

Wenn Sie noch keinen Schlüssel haben, erstellen Sie einen kostenlosen IPGeolocation API-Schlüssel.

Jeder andere MCP-Client

Verwenden Sie diese Konfiguration:

{
  "command": "npx",
  "args": ["-y", "ipgeolocation-io-mcp"],
  "env": {
    "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
  }
}

Überprüfung der Funktion

Probieren Sie diese nach der Einrichtung aus:

Tools nach Plan

Kostenloser Plan

1.000 Credits pro Tag. Diese 7 Tools sind verfügbar:

Kostenpflichtige Pläne

Alle 16 Tools. Kostenpflichtige Pläne fügen auch network, company und erweiterte asn-Felder zu lookup_ip hinzu, sowie den include-Parameter für security, abuse, hostname, liveHostname, hostnameFallbackLive, user_agent, geo_accuracy, dma_code oder *.

Credit-Berechnung für lookup_ip mit include:

Für aktuelle Plandetails und Preise siehe die IPGeolocation-Preisseite.

Tool-Referenz

lookup_ip

Einzel-IP- oder Domain-Lookup. Kostenlos und kostenpflichtig. 1 Credit.

Verwenden Sie dies, wenn Sie Standort, Zeitzone, Währung oder ASN für eine IP-Adresse benötigen. In kostenpflichtigen Plänen können Sie include-Module hinzufügen, um Sicherheits-, Missbrauchs- oder Hostname-Daten im selben Aufruf abzurufen, was zusätzliche Anfragen vermeidet.

Der kostenlose Plan gibt den Basisstandort, Ländermetadaten, Währung, Zeitzone und grundlegende ASN zurück. Kostenpflichtige Pläne fügen network, company, erweiterte ASN und den include-Parameter hinzu. Beachten Sie, dass Domain-Lookups einen kostenpflichtigen Plan erfordern.

Tipp: Die Kombination von include mit fields kann Ihre Credit-Kosten senken. Zum Beispiel kostet include=security&fields=security 2 Credits statt 3, da Sie die Basis-Geolocation-Antwort überspringen. Ebenso kostet include=abuse&fields=abuse 1 Credit statt 2.

bulk_lookup_ip

Batch-IP-Lookup. Kostenpflichtig. 1 Credit pro IP.

Nimmt ein Array von IPs oder Domains entgegen (standardmäßig bis zu 1.000, konfigurierbar mit IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Unterstützt dieselben include-, fields- und excludes-Optionen wie lookup_ip.

get_my_ip

Gibt die öffentliche IP der Maschine zurück, auf der der Server läuft. Kostenlos. 0 Credits. Kein API-Schlüssel erforderlich.

Nimmt keine Parameter entgegen. Fragt immer das Netzwerk ab (nicht gecacht). Nützlich als schnelle Überprüfung, um sicherzustellen, dass der Serverprozess läuft.

check_security

Bedrohungs- und Anonymitätsdaten für eine IP. Kostenpflichtig. 2 Credits.

Gibt Bedrohungs-Score, VPN/Proxy/Tor-Flags, Anbieternamen, Konfidenz-Scores, Bot/Spam-Indikatoren, Anonymitäts-Flags und Cloud-Anbieter-Status zurück.

Wenn derselbe Prompt auch nach Standort, ASN oder Missbrauchsdaten fragt, ist es besser, lookup_ip mit include=security zu verwenden, da dies alles in einem Aufruf bündelt (insgesamt 3 Credits statt 2 + 1 separat).