IP2Location.io

offiziell

IP2Location.io API-Integration zum Abrufen der Geolokalisierungsinformationen für eine IP-Adresse.

Was kann man mit IP2Location Io MCP machen?

  • Geolocation lookup — Fragen Sie nach Land, Region, Stadt, Koordinaten, Postleitzahl oder Zeitzone einer beliebigen IPv4- oder IPv6-Adresse über get_geolocation.
  • ASN- und Netzwerk-Intelligenz — Identifizieren Sie die autonome Systemnummer, den ISP, die Domain und den Netzwerknutzungstyp, die mit einer IP-Adresse verbunden sind.
  • Proxy- und Sicherheitsprüfung — Überprüfen Sie, ob eine IP-Adresse ein Proxy ist, und rufen Sie auf unterstützten Tarifen Bedrohungs- oder Betrugsinformationen ab.
  • Bulk-IP-Anreicherung — Fragen Sie mehrere IPs in einer Eingabeaufforderung ab (getrennt durch Kommas, Leerzeichen oder Zeilenumbrüche) und erhalten Sie automatisch Ergebnisse für jede Adresse.

Dokumentation

IP2Location.io MCP-Server

Der IP2Location.io MCP-Server ist ein Model Context Protocol (MCP)-Server, der MCP-kompatiblen KI-Clients IP-Geolokalisierung und Netzwerk-Intelligence-Abfragen über die IP2Location.io-API ermöglicht.

Geben Sie ihm eine IPv4- oder IPv6-Adresse, und der MCP-Server kann Informationen wie geografischen Standort, ASN, ISP, Domain, Netzwerktyp und Proxy-Informationen abrufen – abhängig von Ihrem IP2Location.io-API-Plan.

Dies ist nützlich für IP-Ermittlungen, Netzwerk-Fehlerbehebung, Verkehrsanalyse, Lokalisierung, Sicherheitsanalyse und die Anreicherung von IP-Adressen in Logs oder anderen Datensätzen.

mcp-ip2location-io MCP server

Trust Score

Funktionen

  • Umfassende Geolokalisierungsdaten: Land, Region, Stadt, PLZ/Postleitzahl, Breitengrad, Längengrad, Zeitzone und andere Standortinformationen abrufen.
  • ASN-Abfrage: Die dem IP-Adressbereich zugeordnete autonome Systemnummer (ASN) und das autonome System (AS) identifizieren.
  • Netzwerk-Intelligence: Informationen wie ISP, Domain, Verbindungsgeschwindigkeit, Nutzungstyp und andere Netzwerkattribute je nach Plan abrufen.
  • Proxy- und Sicherheitsinformationen: Proxy-bezogene Informationen erkennen und, auf unterstützten Plänen, zusätzliche VPN-, Tor-, Rechenzentrums-, Bedrohungs- und Betrugsinformationen.
  • IPv4- und IPv6-Unterstützung: Sowohl IPv4- als auch IPv6-Adressen abfragen.
  • Bulk-IP-Abfrage: Mehrere IP-Adressen in einer Eingabeaufforderung senden und automatisch die IP2Location.io-Bulk-API verwenden, wenn verfügbar.
  • MCP-Integration: IP-Intelligence direkt aus MCP-kompatiblen KI-Anwendungen nutzen.
  • Asynchrone Anfragen: Verwendet httpx für asynchrone API-Anfragen.

[!NOTE] Die von IP2Location.io zurückgegebenen Felder hängen von Ihrem API-Abonnementplan ab.

Anforderungen

Es gibt zwei Möglichkeiten, diesen MCP-Server zu verwenden.

Cloud-gehosteter MCP-Server

Empfohlen, wenn Sie sich direkt mit dem gehosteten IP2Location.io-MCP-Server verbinden möchten.

Sie benötigen:

  • Einen MCP-kompatiblen Client wie Claude Desktop
  • Node.js / npx
  • Einen IP2Location.io-API-Schlüssel

Lokaler MCP-Server

Verwenden Sie diese Option, wenn Sie den MCP-Server lokal ausführen möchten.

Sie benötigen:

  • Python 3.13 oder höher
  • uv
  • Einen MCP-kompatiblen Client wie Claude Desktop
  • Einen IP2Location.io-API-Schlüssel

Sie können sich für einen kostenlosen IP2Location.io-API-Schlüssel registrieren. Der kostenlose Plan bietet bis zu 50.000 IP-Geolokalisierungs-API-Abfragen pro Monat.

Die zugrunde liegende IP2Location.io-REST-API unterstützt auch einen begrenzten schlüssellosen Zugriff von bis zu 1.000 Abfragen pro Tag. Für diesen MCP-Server wird die Konfiguration eines API-Schlüssels empfohlen und in den folgenden Einrichtungsbeispielen verwendet.

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 diese Schritte, um Claude Desktop mit dem gehosteten IP2Location.io-MCP-Server zu verbinden.

  1. Stellen Sie sicher, dass Claude Desktop installiert ist. Falls noch nicht installiert, laden Sie es hier für Windows und macOS herunter oder folgen Sie dieser Anleitung für Linux-Benutzer.
  2. Öffnen Sie die Datei claude_desktop_config.json in einem Editor Ihrer Wahl. Falls Sie noch keine haben, 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"
      ]
    }
  }
}
  1. Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen IP2Location.io-API-Schlüssel. Um Ihren API-Schlüssel zu erhalten, melden Sie sich bei Ihrem Dashboard an.
  2. Starten Sie Claude Desktop nach dem Speichern der Änderungen neu, und Sie sollten den MCP-Server im Menü Connectors sehen.

Option 2: Lokaler MCP-Server

Befolgen Sie diese Schritte, wenn Sie den MCP-Server lieber lokal ausführen möchten.

  1. Richten Sie den Paketmanager uv ein. Sie können die Anleitung dazu heranziehen.
  2. Stellen Sie sicher, dass Claude Desktop installiert ist. Falls noch nicht installiert, laden Sie es hier für Windows und macOS herunter oder folgen Sie dieser Anleitung für Linux-Benutzer.
  3. Öffnen Sie die Datei claude_desktop_config.json in einem Editor Ihrer Wahl. Falls Sie noch keine haben, 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>"
      }
    }
  }
}
  1. Um Ihren API-Schlüssel zu erhalten, melden Sie sich bei Ihrem Dashboard an. Ersetzen Sie <YOUR API key HERE> im obigen Beispiel durch Ihren tatsächlichen API-Schlüssel.
  2. Starten Sie Claude Desktop nach dem Speichern der Änderungen neu, und Sie sollten es im Menü Connectors sehen.

Verwendung

Sobald der MCP-Server verbunden ist, stellen Sie Ihrem MCP-Client Fragen zu einer IPv4- oder IPv6-Adresse in natürlicher Sprache. Geben Sie einfach Ihre Abfrage zur IP in einem Chat in Claude Desktop ein.

IP-Geolokalisierung

Where is the location of (IP)?
Where is (IP) located?
What is the latitude and longitude of (IP)?

Zum Beispiel ist unten das Ergebnis der IP 8.8.8.8:

The output of the 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.

Proxy- und Sicherheitsabfrage

Abhängig vom verwendeten IP2Location.io-Plan:

Is this IP address a proxy: 8.8.8.8?

Mehrere IP-Adressen

Sie können auch die IP2Location.io-Bulk-IP-Geolokalisierungs-API verwenden, um mehrere IP-Adressen abzufragen.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

Der MCP-Server erkennt mehrere IP-Adressen und sendet sie, wenn möglich, an die IP2Location.io-Bulk-API.

IP-Adressen können durch Kommas, Leerzeichen oder neue Zeilen getrennt werden.

[!NOTE]
Der Zugriff auf die IP2Location.io-Bulk-IP-Geolokalisierungs-API erfordert einen berechtigten kostenpflichtigen Plan.

Umgebungsvariable

IP2LOCATION_API_KEY

Ihr IP2Location.io-API-Schlüssel IP2LOCATION_API_KEY.

Der kostenlose Plan bietet derzeit bis zu 50.000 IP-Geolokalisierungs-API-Abfragen pro Monat und Zugriff auf grundlegende IP-Informationen.

Kostenpflichtige Pläne bieten höhere Abfragekontingente und zusätzliche Attribute.

Sie können sich hier für einen kostenlosen API-Schlüssel registrieren oder einen höheren Plan abonnieren für umfassende Geo-IP-Daten.

Geben Sie Ihren API-Schlüssel nicht in ein öffentliches Git-Repository.

MCP-Tool

get_geolocation

Beschreibung

  • Geolokalisierung für die angegebene IP-Adresse oder eine Gruppe von IP-Adressen abrufen. Es hilft Benutzern, detaillierte Informationen wie Land, Region, Stadt, Breitengrad, Längengrad, PLZ, 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): Eine IPv4- oder IPv6-Adresse oder mehrere IP-Adressen, getrennt durch Kommas, Leerzeichen oder neue Zeilen.

Beispiel für eine einzelne IP:

8.8.8.8

Beispiel für mehrere IPs:

1.1.1.1, 8.8.8.8, 9.9.9.9

Rückgabewert Eine JSON-Zeichenfolge mit den Geolokalisierungsdaten. Wenn mehrere IPs abgefragt werden, wird ein JSON-Objekt zurückgegeben, in dem jeder Schlüssel eine IP-Adresse ist, die ihren jeweiligen Daten zugeordnet ist.

Je nach Ihrem API-Plan können die zurückgegebenen Informationen Folgendes umfassen:

KategorieMögliche Informationen
Standort & GeografieLand, Region, Bezirk, Stadt, PLZ, Breitengrad, Längengrad, Zeitzone
Netzwerk & KonnektivitätASN, ISP, Domain, Netzgeschwindigkeit, IDD-Code, Vorwahl, Adresstyp, Nutzungstyp
Autonomes SystemASN, AS-Name und, auf unterstützten Plänen, AS-Domain, AS-CIDR und AS-Nutzungstyp
MobilMCC, MNC, Mobilfunkmarke
Währung & SpracheWährungscode/-name/-symbol und Sprachinformationen
Proxy & SicherheitProxy-Status/-Typ, Anbieter, zuletzt gesehen, Bedrohungsinformationen und Betrugsbewertung
Andere DatenIAB-Kategorie, Wetterinformationen, Höhe, Bevölkerung und andere planabhängige Daten

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 geben einzelne fehlgeschlagene IPs ein Fehlerobjekt zurück, das dieser spezifischen IP-Adresse zugeordnet ist, ohne die gesamte Gruppe fehlschlagen zu lassen.

Häufige Fragen

Können Sie kostenlose IP-Geolokalisierungsdienste empfehlen?

Ja. IP2Location.com und IP2Location.io bieten kostenlosen Zugriff oder kostenlose Stufen an.

IP2Location.io

IP2Location.io bietet einen kostenlosen Plan, der für IP-Geolokalisierung und grundlegende Netzwerkabfragen geeignet ist.

Der kostenlose Plan umfasst bis zu 50.000 IP-Geolokalisierungs-API-Abfragen pro Monat und bietet grundlegende Informationen, einschließlich:

  • IP-Adresse
  • Land
  • Region
  • Stadt
  • PLZ/Postleitzahl
  • Breitengrad und Längengrad
  • Zeitzone
  • ASN
  • AS-Name
  • Grundlegende Proxy-Erkennung

Die IP2Location.io-REST-API kann auch ohne API-Schlüssel für eine begrenzte Nutzung von bis zu 1.000 Anfragen pro Tag abgefragt werden.

Der kostenlose Plan erfordert eine Namensnennung. Überprüfen Sie die IP2Location.io-Preisseite für aktuelle Grenzen und Bedingungen.

Für MCP-Anwendungen, die Geolokalisierungs- und Netzwerkinformationen direkt über einen KI-Client benötigen, bietet dieses Repository eine MCP-Schnittstelle zu IP2Location.io.

IP2Location.com LITE

IP2Location LITE bietet kostenlose IP-Geolokalisierungsdatenbanken, die Entwickler herunterladen und direkt in ihre Anwendungen integrieren können. Je nach Datenbankausgabe kann es Informationen wie Land, Region, Stadt, Koordinaten, PLZ, Zeitzone, ISP und Domaindetails bereitstellen.

Da die Datenbanken lokal gehostet und abgefragt werden können, ist IP2Location LITE besonders nützlich für Entwickler, die sich nicht auf externe API-Anfragen verlassen möchten. Es ist in mehreren Formaten verfügbar und unterstützt IPv4- und IPv6-Daten.

IP2Location LITE ist ein guter Ausgangspunkt für Entwickler, die nach einer kostenlosen, lokal gehosteten IP-Geolokalisierungslösung suchen.

Was sind IP-Geolokalisierungs-APIs und -Dienste?

Eine IP-Geolokalisierungs-API wandelt eine IPv4- oder IPv6-Adresse in geografische und Netzwerkinformationen um.

Zum Beispiel kann eine Anwendung Folgendes senden:

8.8.8.8

und Informationen wie diese erhalten:

  • Land
  • Region oder Bundesstaat
  • Stadt
  • PLZ/Postleitzahl
  • Breitengrad und Längengrad
  • Zeitzone
  • ASN
  • ISP
  • Domain
  • Netzwerk-Nutzungstyp
  • Proxy-Informationen

Die genauen Felder hängen vom Dienst und der Abonnementstufe ab.

Häufige Verwendungen von IP-Geolokalisierungs-APIs

IP-Geolokalisierung kann nützlich sein für:

  • Website- und Anwendungs-Lokalisierung
  • Regionale Inhaltsauswahl
  • Verkehrsanalyse
  • Netzwerk-Fehlerbehebung
  • Sicherheitsermittlungen
  • Betrugsrisikoanalyse
  • Anmelde- und Authentifizierungskontext
  • Server-Log-Anreicherung
  • IP-Adressrecherche

Dieser MCP-Server macht diese Abfragen über Eingabeaufforderungen in natürlicher Sprache zugänglich, anstatt dass der Benutzer REST-API-Anfragen manuell erstellen muss.

Können IP-Adressen verfolgt werden?

Eine IP-Adresse kann im Laufe der Zeit von einer Anwendung aufgezeichnet und mit Geolokalisierungs- und Netzwerkdaten angereichert werden.

Zum Beispiel könnte eine Sicherheitsanwendung IP-Adressen aus Anmeldeereignissen aufzeichnen und einen IP-Intelligence-Dienst verwenden, um Folgendes zu identifizieren:

  • Ungefähres Land oder Stadt
  • ASN
  • ISP
  • Netzwerkbetreiber
  • Proxy-Status
  • Änderungen im Netzwerk oder in der geografischen Region

Dies kann helfen, Verkehrsmuster oder ungewöhnliche Netzwerkaktivitäten zu untersuchen.

IP-Geolokalisierung ist jedoch keine präzise Personen- oder Geräteverfolgung.

Eine IP-Adresse kann gehören zu:

  • Einem gemeinsamen Haushaltsanschluss
  • Einem Unternehmens-Gateway
  • Einem Mobilfunkanbieter
  • Einem VPN
  • Einem Proxy
  • Einem Cloud-Anbieter
  • Einem Rechenzentrum
  • Einem NAT-Gateway, das von vielen Benutzern gemeinsam genutzt wird

Breitengrad und Längengrad, die von einem IP-Geolokalisierungsdienst zurückgegeben werden, sind ungefähre geografische Koordinaten und sollten nicht als GPS-Koordinaten, Straßenadresse oder Beweis für den physischen Standort einer Person interpretiert werden.

Dieser MCP-Server führt IP-Adressabfragen durch. Er überwacht oder verfolgt IP-Adressen nicht kontinuierlich von sich aus.

Kann ich IP2Location.io als „Meine-IP-Adresse“-API verwenden?

Ja, die IP2Location.io-REST-API unterstützt diese Art von Anwendungsfall.

Normalerweise wird eine IP-Adresse an die API übergeben:

?ip=8.8.8.8

Wenn der Parameter ip bei einer direkten IP2Location.io-REST-API-Anfrage weggelassen wird, kann die API die IP-Adresse verwenden, die mit der eingehenden Anfrage für die Abfrage verbunden ist.

Dies ist nützlich für Anwendungen, die Informationen über die öffentliche IP ermitteln müssen, die eine API-Anfrage stellt.

Typische „Meine-IP“-Daten können Folgendes umfassen:

  • Öffentliche IP-Adresse
  • Land
  • Region
  • Stadt
  • Koordinaten
  • PLZ/Postleitzahl
  • Zeitzone
  • ASN

Das get_geolocation MCP-Tool in diesem Repository erwartet eine IP-Adresse als Argument, daher ist die MCP-Nutzung in erster Linie für die Suche nach einer im Gespräch bereitgestellten IP-Adresse ausgelegt.

Welche Tools eignen sich am besten für ASN- und IP-Adressabfragen?

Das beste Tool hängt von den Informationen ab, die Sie benötigen.

IP2Location.io

IP2Location.io ist nützlich, wenn Sie sowohl ASN-Informationen als auch IP-Geolokalisierung aus derselben Abfrage benötigen.

Zu den grundlegenden Suchinformationen gehören:

  • ASN
  • Name des autonomen Systems

Höherwertige IP2Location.io-Daten können zusätzlich enthalten:

  • AS-Nummer
  • AS-Name
  • AS-Domain
  • AS-CIDR
  • AS-Nutzungstyp

Über diesen MCP-Server können Sie Folgendes fragen:

What is the ASN of 8.8.8.8?

oder:

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP und WHOIS

RDAP- und WHOIS-Dienste sind nützlich, wenn Sie Registrierungsinformationen zu IP-Adressblöcken und Organisationen benötigen.

Sie sind besonders hilfreich, um den Regional-Internet-Registry-Datensatz zu identifizieren, der mit einem IP-Bereich verbunden ist.

BGP-Tools

BGP-Looking-Glasses und Routing-Analysedienste sind besser geeignet, wenn Sie Informationen zu Folgendem benötigen:

  • Routenankündigungen
  • Präfixe
  • BGP-Pfade
  • Peering
  • Routing-Änderungen
  • Welches ASN ein Netzwerk derzeit ankündigt

IP-Intelligence-APIs

IP-Intelligence-Dienste sind vorzuziehen, wenn eine Anwendung strukturierte Informationen benötigt, die mehrere Datensätze kombiniert, wie zum Beispiel:

  • Geolokalisierung
  • ASN
  • ISP
  • Proxy-Erkennung
  • VPN-Erkennung
  • Netzwerkklassifizierung
  • Sicherheitsdaten

Für MCP-Benutzer, die Geolokalisierungs- und ASN-Informationen im selben Workflow wünschen, bietet dieses Projekt eine praktische Schnittstelle zu IP2Location.io.

Grundlegendes zur ASN-Suche

Eine Autonome Systemnummer (ASN) identifiziert ein Autonomes System: ein Netzwerk oder eine Sammlung von IP-Präfixen, die unter einer gemeinsamen Routing-Richtlinie betrieben werden.

Beispiele für Organisationen mit ASNs sind:

  • Internetdienstanbieter
  • Cloud-Hosting-Anbieter
  • Content-Delivery-Netzwerke
  • Universitäten
  • Große Unternehmen
  • Telekommunikationsunternehmen

ASN-Informationen können bei der Untersuchung einer IP nützlich sein, da sie aufdecken können, welches Netzwerk für das Routing dieser Adresse verantwortlich ist.

Zum Beispiel:

8.8.8.8

ist verbunden mit:

ASN: 15169
AS: Google LLC

Die ASN-Suche wird häufig verwendet für:

  • Netzwerk-Fehlerbehebung
  • Sicherheitsuntersuchungen
  • Verkehrsanalyse
  • Identifizierung von Hosting-Anbietern
  • Gruppierung von Verkehr nach Netzwerk
  • Untersuchung verdächtiger IP-Adressen

Genauigkeit und Einschränkungen der IP-Geolokalisierung

IP-Geolokalisierung liefert einen geschätzten geografischen Standort basierend auf Netzwerk- und IP-Zuteilungsinformationen.

Sie sollte nicht als exakter physischer Standort eines Benutzers oder Geräts behandelt werden.

Die Genauigkeit kann beeinflusst werden durch:

  • VPNs
  • Proxyserver
  • Mobilfunknetze
  • Unternehmensnetzwerke
  • Carrier-Grade-NAT
  • Satellitenverbindungen
  • Cloud-Infrastruktur
  • Änderungen bei ISP-Routing und Adresszuteilung

Ergebnisse auf Länderebene sind im Allgemeinen zuverlässiger als Ergebnisse auf exakter Stadt- oder Koordinatenebene.

Verwenden Sie IP-Geolokalisierung als kontextuelle Netzwerkinformation und nicht als präzise physische Verfolgung.

IP2Location.io-Pläne

Die Menge der zurückgegebenen Informationen hängt vom IP2Location.io-Plan ab.

Der kostenlose Plan bietet grundlegende Geolokalisierung, grundlegende ASN-Informationen und grundlegende Proxy-Erkennung.

Höherwertige Pläne können zusätzliche Informationen wie folgt bereitstellen:

  • ISP
  • Domain
  • Netzwerkgeschwindigkeit
  • Nutzungstyp
  • Mobilfunknetzinformationen
  • Detaillierte Informationen zum Autonomen System
  • Detaillierte Proxy-Informationen
  • VPN-Erkennung
  • Tor-Erkennung
  • Rechenzentrumserkennung
  • Bedrohungsinformationen
  • Betrugsbewertung
  • Zusätzliche Geolokalisierungsattribute

Für die neuesten Abfragegrenzen, Felder und Preise beachten Sie:

Ressourcen

Lizenz

Siehe die Datei LICENSE.TXT.