IP2Location.io MCP-Server

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

Funktionen

• Umfassende Geolokalisierungsdaten: Ruft eine Vielzahl von Informationen ab, darunter Land, Region, Stadt, Breitengrad, Längengrad, Postleitzahl, Zeitzone und mehr.

• Netzwerkdetails: Bietet netzwerkbezogene Daten wie ASN, ISP, Domain und Netzwerkgeschwindigkeit.

• Sicherheitserkenntnisse: Erkennt Proxy-Informationen, einschließlich Proxy-Typ und Anbieter.

• Einfache Integration: Als FastMCP-Tool erstellt, was eine einfache Integration in kompatible Systeme ermöglicht.

• Asynchron: Nutzt httpx für nicht blockierende, asynchrone API-Anfragen.

Anforderungen

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.

Das Setup verwendet außerdem uv, das gemäß dieser Anleitung installiert werden kann.

Einrichtung

Befolgen Sie die Schritte, um diesen MCP-Server mit Claude Desktop zu verwenden:

1. Laden Sie das Repository lokal herunter.

2. Richten Sie den uv-Paketmanager ein; Sie können hierfür erneut die Anleitung verwenden.

3. Stellen Sie sicher, dass Sie Claude Desktop installiert haben. Falls nicht, laden Sie es bitte hier für Windows und MacOS herunter oder folgen Sie dieser Anleitung für Linux-Benutzer.

4. Öffnen Sie die claude_desktop_config.json in einem Editor Ihrer Wahl. Falls Sie noch keine haben, folgen Sie dieser Anleitung, um eine zu erstellen.

5. Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

6. Denken Sie daran, den Pfad /path/to/ip2locationio durch Ihren tatsächlichen lokalen Pfad zum IP2Location.io MCP-Server zu ersetzen.

7. Um Ihren API-Schlüssel zu erhalten, melden Sie sich einfach in Ihrem Dashboard an und rufen Sie ihn dort ab. Ersetzen Sie <YOUR API key HERE> oben durch Ihren tatsächlichen API-Schlüssel.

8. Starten Sie Claude Desktop nach dem Speichern der Änderungen neu; er sollte dann im Menü Connectors erscheinen.

Verwendung

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

• Wo befindet sich der Standort von (IP)?

• Wo ist (IP) lokalisiert?

• Was sind die Koordinaten von (IP)?

Hier ist zum Beispiel das Ergebnis für die IP 8.8.8.8:

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

Sie können auch die IP2Location.io Bulk IP Geolocation API verwenden, 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.

Umgebungsvariable

IP2LOCATION_API_KEY

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

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 bei Erkennung mehrerer IPs automatisch zur effizienten Verarbeitung an die IP2Location.io Bulk API weiter.

Argumente

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

Rückgabewerte Eine JSON-Zeichenfolge, die 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, Breitengrad & Längengrad, Zeitzone.

• Netzwerk & Konnektivität: ASN (Autonomous System Number), ISP (Internet Service Provider), Domain, Netzwerkgeschwindigkeit, IDD-Vorwahl, 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, Bedrohungsgrad/-typ, Proxy-Anbieter, Betrugs-Score.

• 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 Bulk-Anfragen gibt jede einzelne fehlgeschlagene IP ein Fehlerobjekt zurück, das dieser spezifischen IP-Adresse zugeordnet ist, ohne dass die gesamte Gruppe fehlschlägt.

Lizenz

Siehe die LICENSE-Datei.