IP2Location.io

IP2Location.io MCP-Server

Dies ist eine einfache Model Context Protocol (MCP)-Server-Implementierung für die IP2Location.io API. Sie liefert detaillierte Geolokalisierungsinformationen für jede angegebene IPv4- oder IPv6-Adresse.

Funktionen

• Umfassende Geolokalisierungsdaten: Ruft eine breite Palette von Informationen ab, darunter Land, Region, Stadt, Breitengrad, Längengrad, Postleitzahl, Zeitzone und mehr.
• Netzwerkdetails: Liefert netzwerkbezogene Daten wie ASN, ISP, Domain und Netzwerkgeschwindigkeit.
• Sicherheitseinblicke: Erkennt Proxy-Informationen, einschließlich Proxy-Typ und Anbieter.
• Einfache Integration: Als FastMCP-Tool konzipiert, das eine einfache Integration in kompatible Systeme ermöglicht.
• Asynchron: Verwendet httpx für nicht-blockierende asynchrone API-Anfragen.

Voraussetzung

Dieser MCP-Server unterstützt Abfragen ohne API-Schlüssel, mit einer Begrenzung von 1.000 Abfragen pro Tag. Sie können sich auch für einen kostenlosen API-Schlüssel registrieren und bis zu 50.000 Abfragen pro Monat nutzen.

Wenn Sie den cloud-gehosteten MCP-Server verwenden, benötigen Sie nur Claude Desktop und npx, da der Server remote gehostet wird. Wenn Sie den ursprünglichen MCP-Server lokal ausführen möchten, verwendet das lokale Setup uv, das durch Befolgen der Anleitung installiert werden kann.

Einrichtung

Sie können diesen MCP-Server in Claude Desktop auf eine der folgenden Arten verwenden:

• Cloud-gehosteter MCP-Server: Empfohlen, wenn Sie sich direkt mit dem gehosteten IP2Location.io MCP-Server verbinden möchten.
• Lokaler MCP-Server: Verwenden Sie dies, wenn Sie den ursprünglichen MCP-Server auf Ihrem eigenen Rechner herunterladen und ausführen möchten.

Option 1: Cloud-gehosteter MCP-Server

Befolgen Sie die folgenden Schritte, um den cloud-gehosteten IP2Location.io MCP-Server mit Claude Desktop zu verwenden:

1. Stellen Sie sicher, dass Sie Claude Desktop installiert haben. Falls noch nicht geschehen, laden Sie es hier für Windows und macOS herunter oder folgen Sie dieser Anleitung für Linux-Benutzer.
2. Öffnen Sie die claude_desktop_config.json-Datei in einem Editor Ihrer Wahl. Falls noch keine vorhanden ist, folgen Sie dieser Anleitung, um eine zu erstellen.
3. Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

4. Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen IP2Location.io API-Schlüssel. Um Ihren API-Schlüssel zu erhalten, melden Sie sich in Ihrem Dashboard an.
5. Starten Sie Claude Desktop nach dem Speichern der Änderungen neu, und Sie sollten den MCP-Server im Connectors-Menü sehen.

Option 2: Lokaler MCP-Server

Befolgen Sie die folgenden Schritte, wenn Sie den ursprünglichen MCP-Server lokal mit Claude Desktop ausführen möchten:

1. Richten Sie den uv-Paketmanager ein. Sie können sich dazu auf die Anleitung beziehen.
2. Stellen Sie sicher, dass Sie Claude Desktop installiert haben. Falls noch nicht geschehen, laden Sie es hier für Windows und macOS herunter oder folgen Sie dieser Anleitung für Linux-Benutzer.
3. Öffnen Sie die claude_desktop_config.json-Datei in einem Editor Ihrer Wahl. Falls noch keine vorhanden ist, folgen Sie dieser Anleitung, um eine zu erstellen.
4. Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

5. Um Ihren API-Schlüssel zu erhalten, melden Sie sich in Ihrem Dashboard an. Ersetzen Sie <YOUR API key HERE> im obigen Beispiel durch Ihren tatsächlichen API-Schlüssel.
6. Starten Sie Claude Desktop nach dem Speichern der Änderungen neu, und Sie sollten ihn im Connectors-Menü sehen.

Verwendung

Geben Sie einfach Ihre Anfrage zur IP in einem Chat in Claude Desktop ein. Einige Beispielfragen wären:

• Wo befindet sich (IP)?
• Wo liegt (IP)?
• Wie lauten die Koordinaten von (IP)?

Zum Beispiel ist unten das Ergebnis für die IP 8.8.8.8 dargestellt:

In Claude Desktop generiert das Modell die Ausgabe automatisch basierend auf dem vom IP2Location.io MCP-Server zurückgegebenen Ergebnis.

Sie können auch die IP2Location.io Bulk IP Geolocation API nutzen, um mehrere IP-Adressen abzufragen. Geben Sie einfach alle IP-Adressen mit einem Leerzeichen zwischen den einzelnen IP-Adressen ein. Zum Beispiel 8.8.8.8 8.8.6.6.

[!NOTE]
Die IP2Location.io Bulk IP Geolocation API erfordert einen kostenpflichtigen Plan, um zu funktionieren.

Umgebungsvariable

IP2LOCATION_API_KEY

Der IP2Location.io API-Schlüssel, mit dem Sie bis zu 50.000 Abfragen pro Monat und detailliertere Informationen zur IP-Adresse erhalten. Sie können sich für einen kostenlosen API-Schlüssel registrieren oder einen Plan abonnieren, um weitere Vorteile zu genießen.

Tool

get_geolocation

Beschreibung Ruft die Geolokalisierung für die angegebene IP-Adresse oder eine Gruppe von IP-Adressen ab. Es hilft Benutzern, detaillierte Informationen wie Land, Region, Stadt, Breitengrad, Längengrad, Postleitzahl, Zeitzone, ASN und Proxy-Informationen für jede IPv4- oder IPv6-Adresse abzurufen. Es leitet Anfragen automatisch an die IP2Location.io Bulk API zur effizienten Verarbeitung weiter, wenn mehrere IPs erkannt werden.

Argumente

• ip (str): Die zu analysierende IP-Adresse (IPv4 oder IPv6). Sie können mehrere IPs gleichzeitig abfragen, indem Sie sie als einzelne Zeichenfolge, getrennt durch Kommas, Leerzeichen oder Zeilenumbrüche, übergeben (z. B. "1.1.1.1, 2.2.2.2").

Rückgabe Ein JSON-String, der die Geolokalisierungsdaten enthält. Wenn mehrere IPs abgefragt werden, wird ein JSON-Objekt zurückgegeben, bei dem jeder Schlüssel eine IP-Adresse ist, die ihren jeweiligen Daten zugeordnet ist. Das Ergebnis kann je nach API-Plan die folgenden Felder enthalten:

• Standort & Geografie: Land, Region, Bezirk, Stadt, Postleitzahl, Breiten- & Längengrad, Zeitzone.
• Netzwerk & Konnektivität: ASN (Autonomous System Number), ISP (Internet Service Provider), Domain, Netzgeschwindigkeit, IDD-Code, Ortsvorwahl, Adresstyp, Nutzungstyp.
• Mobilfunkinformationen: MNC (Mobile Network Code), MCC (Mobile Country Code), Mobilfunkmarke.
• Währung & Sprache: Währungscode, Währungsname, Währungssymbol, Sprachcode, Sprachname.
• Proxy & Sicherheit: Proxy-Typ, zuletzt gesehen, Bedrohungsstufe/-typ, Proxy-Anbieter, Betrugsbewertung.
• Sonstiges: IAB-Kategorie, Wetter, Höhe, Bevölkerung und mehr.

Wenn eine einzelne IP-Anfrage fehlschlägt oder die IP ungültig ist, gibt das Tool eine Fehlermeldung als Zeichenfolge zurück. Bei Massenanfragen geben einzelne fehlgeschlagene IPs ein Fehlerobjekt zurück, das dieser spezifischen IP-Adresse zugeordnet ist, ohne dass der gesamte Stapel fehlschlägt.

Lizenz

Siehe die LICENSE-Datei.