IP2Location.io

Serveur MCP IP2Location.io

Le serveur MCP IP2Location.io est un serveur Model Context Protocol (MCP) qui permet aux clients IA compatibles MCP d'effectuer des recherches de géolocalisation d'adresses IP et de renseignements sur le réseau à l'aide de l'API IP2Location.io.

Fournissez-lui une adresse IPv4 ou IPv6 et le serveur MCP peut récupérer des informations telles que la localisation géographique, l'ASN, le FAI, le domaine, le type de réseau et les informations de proxy, selon votre plan API IP2Location.io.

Cela le rend utile pour les enquêtes sur les IP, le dépannage réseau, l'analyse du trafic, la localisation, l'analyse de sécurité et l'enrichissement des adresses IP trouvées dans les journaux ou d'autres ensembles de données.

Fonctionnalités

• Données de géolocalisation complètes : Récupérez le pays, la région, la ville, le code postal, la latitude, la longitude, le fuseau horaire et d'autres informations de localisation.
• Recherche ASN : Identifiez le numéro de système autonome (ASN) et le système autonome (AS) associés à une adresse IP.
• Renseignements réseau : Récupérez des informations telles que le FAI, le domaine, la vitesse de connexion, le type d'utilisation et d'autres attributs réseau selon votre plan.
• Informations sur les proxys et la sécurité : Détectez les informations liées aux proxys et, sur les plans pris en charge, des informations supplémentaires sur les VPN, Tor, les centres de données, les menaces et la fraude.
• Prise en charge IPv4 et IPv6 : Interrogez les adresses IPv4 et IPv6.
• Recherche d'IP en masse : Envoyez plusieurs adresses IP dans une seule invite et utilisez automatiquement l'API Bulk IP2Location.io lorsqu'elle est disponible.
• Intégration MCP : Utilisez les renseignements IP directement depuis des applications IA compatibles MCP.
• Requêtes asynchrones : Utilise httpx pour les requêtes API asynchrones.

[!NOTE] Les champs renvoyés par IP2Location.io dépendent de votre plan d'abonnement API.

Exigences

Il existe deux façons d'utiliser ce serveur MCP.

Serveur MCP hébergé dans le cloud

Recommandé lorsque vous souhaitez vous connecter directement au serveur MCP IP2Location.io hébergé.

Vous avez besoin de :

• Un client compatible MCP tel que Claude Desktop
• Node.js / npx
• Une clé API IP2Location.io

Serveur MCP local

Utilisez cette option lorsque vous souhaitez exécuter le serveur MCP localement.

Vous avez besoin de :

• Python 3.13 ou version ultérieure
• uv
• Un client compatible MCP tel que Claude Desktop
• Une clé API IP2Location.io

Vous pouvez vous inscrire pour obtenir une clé API IP2Location.io gratuite. Le plan gratuit offre jusqu'à 50 000 requêtes API de géolocalisation IP par mois.

L'API REST IP2Location.io sous-jacente prend également en charge un accès limité sans clé allant jusqu'à 1 000 requêtes par jour. Pour ce serveur MCP, la configuration d'une clé API est recommandée et est utilisée dans les exemples de configuration ci-dessous.

Configuration

Vous pouvez utiliser ce serveur MCP dans Claude Desktop de l'une des manières suivantes :

• Serveur MCP hébergé dans le cloud : Recommandé si vous souhaitez vous connecter directement au serveur MCP IP2Location.io hébergé.
• Serveur MCP local : Utilisez cette option si vous souhaitez télécharger et exécuter le serveur MCP d'origine sur votre propre machine.

Option 1 : Serveur MCP hébergé dans le cloud

Suivez ces étapes pour connecter Claude Desktop au serveur MCP IP2Location.io hébergé.

1. Assurez-vous d'avoir installé Claude Desktop. Si vous ne l'avez pas encore installé, téléchargez-le ici pour Windows et macOS, ou suivez ce guide pour les utilisateurs Linux.
2. Ouvrez le fichier claude_desktop_config.json dans l'éditeur de votre choix. Si vous n'en avez pas encore, suivez ce guide pour en créer un.
3. Ajoutez ce qui suit à votre claude_desktop_config.json :

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

4. Remplacez YOUR_API_KEY par votre clé API IP2Location.io réelle. Pour obtenir votre clé API, connectez-vous à votre tableau de bord.
5. Redémarrez Claude Desktop après avoir enregistré les modifications, et vous devriez voir le serveur MCP apparaître dans le menu Connectors.

Option 2 : Serveur MCP local

Suivez ces étapes si vous préférez exécuter le serveur MCP localement.

1. Configurez le gestionnaire de paquets uv. Vous pouvez vous référer à ce guide pour le faire.
2. Assurez-vous d'avoir installé Claude Desktop. Si vous ne l'avez pas encore installé, téléchargez-le ici pour Windows et macOS, ou suivez ce guide pour les utilisateurs Linux.
3. Ouvrez le fichier claude_desktop_config.json dans l'éditeur de votre choix. Si vous n'en avez pas encore, suivez ce guide pour en créer un.
4. Ajoutez ce qui suit à votre claude_desktop_config.json :

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

5. Pour obtenir votre clé API, connectez-vous à votre tableau de bord. Remplacez <YOUR API key HERE> dans l'exemple ci-dessus par votre clé API réelle.
6. Redémarrez Claude Desktop après avoir enregistré les modifications, et vous devriez le voir apparaître dans le menu Connectors.

Utilisation

Une fois le serveur MCP connecté, posez à votre client MCP des questions sur une adresse IPv4 ou IPv6 en langage naturel. Saisissez simplement votre requête concernant l'IP dans une conversation dans Claude Desktop.

Géolocalisation IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Par exemple, voici le résultat de l'IP 8.8.8.8 :

Dans Claude Desktop, le modèle générera automatiquement la sortie en fonction du résultat renvoyé par le serveur MCP IP2Location.io.

Recherche de proxy et de sécurité

Selon le plan IP2Location.io utilisé :

Is this IP address a proxy: 8.8.8.8?

Plusieurs adresses IP

Vous pouvez également utiliser l'API Bulk IP Geolocation IP2Location.io pour interroger plusieurs adresses IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

Le serveur MCP détecte plusieurs adresses IP et les envoie à l'API Bulk IP2Location.io lorsque cela est possible.

Les adresses IP peuvent être séparées par des virgules, des espaces ou des sauts de ligne.

[!NOTE]
L'accès à l'API Bulk IP Geolocation IP2Location.io nécessite un plan payant éligible.

Variable d'environnement

IP2LOCATION_API_KEY

Votre clé API IP2Location.io IP2LOCATION_API_KEY.

Le plan gratuit offre actuellement jusqu'à 50 000 requêtes API de géolocalisation IP par mois et l'accès aux informations IP de base.

Les plans payants offrent des quotas de requêtes plus élevés et des attributs supplémentaires.

Vous pouvez vous inscrire pour obtenir une clé API gratuite, ou vous abonner à un plan supérieur pour des données géo-IP complètes.

Ne commettez pas votre clé API dans un dépôt Git public.

Outil MCP

get_geolocation

Description

• Récupère la géolocalisation pour l'adresse IP donnée ou un lot d'adresses IP. Il aide les utilisateurs à récupérer des informations détaillées telles que le pays, la région, la ville, la latitude, la longitude, le code postal, le fuseau horaire, l'ASN et les informations de proxy pour toute adresse IPv4 ou IPv6. Il achemine automatiquement les requêtes vers l'API Bulk IP2Location.io pour un traitement efficace lorsque plusieurs IP sont détectées.

Arguments

• ip (str) : Une adresse IPv4 ou IPv6, ou plusieurs adresses IP séparées par des virgules, des espaces ou des sauts de ligne.

Exemple d'IP unique :

8.8.8.8

Exemple d'IP multiples :

1.1.1.1, 8.8.8.8, 9.9.9.9

Valeur de retour Une chaîne JSON contenant les données de géolocalisation. Si plusieurs IP sont interrogées, elle renvoie un objet JSON où chaque clé est une adresse IP mappée à ses données respectives.

Selon votre plan API, les informations renvoyées peuvent inclure :

Catégorie	Informations possibles
Localisation et géographie	Pays, région, district, ville, code postal, latitude, longitude, fuseau horaire
Réseau et connectivité	ASN, FAI, domaine, vitesse du réseau, code IDD, code de zone, type d'adresse, type d'utilisation
Système autonome	ASN, nom AS et, sur les plans pris en charge, domaine AS, CIDR AS et type d'utilisation AS
Mobile	MCC, MNC, marque mobile
Devise et langue	Code/nom/symbole de devise et informations linguistiques
Proxy et sécurité	Statut/type de proxy, fournisseur, dernière vue, informations sur les menaces et score de fraude
Autres données	Catégorie IAB, informations météorologiques, altitude, population et autres données dépendantes du plan

Si une requête d'IP unique échoue ou si l'IP est invalide, l'outil renvoie un message d'erreur sous forme de chaîne. Pour les requêtes en masse, toute IP individuelle en échec renverra un objet d'erreur mappé à cette adresse IP spécifique sans faire échouer l'ensemble du lot.

Questions courantes

Pouvez-vous recommander des services gratuits de géolocalisation IP ?

Oui. IP2Location.com et IP2Location.io offrent un accès gratuit ou des niveaux gratuits.

IP2Location.io

IP2Location.io fournit un plan gratuit adapté à la géolocalisation IP et aux recherches réseau de base.

Le plan gratuit comprend jusqu'à 50 000 requêtes API de géolocalisation IP par mois et fournit des informations de base, notamment :

• Adresse IP
• Pays
• Région
• Ville
• Code postal
• Latitude et longitude
• Fuseau horaire
• ASN
• Nom AS
• Détection de proxy de base

L'API REST IP2Location.io peut également être interrogée sans clé API pour une utilisation limitée allant jusqu'à 1 000 requêtes par jour.

Le plan gratuit nécessite une attribution. Consultez la page de tarification IP2Location.io pour connaître les limites et conditions actuelles.

Pour les applications MCP qui ont besoin d'informations de géolocalisation et de réseau directement via un client IA, ce dépôt fournit une interface MCP vers IP2Location.io.

IP2Location.com LITE

IP2Location LITE fournit des bases de données gratuites de géolocalisation IP que les développeurs peuvent télécharger et intégrer directement dans leurs applications. Selon l'édition de la base de données, elle peut fournir des informations telles que le pays, la région, la ville, les coordonnées, le code postal, le fuseau horaire, le FAI et les détails du domaine.

Comme les bases de données peuvent être hébergées et interrogées localement, IP2Location LITE est particulièrement utile pour les développeurs qui préfèrent ne pas dépendre de requêtes API externes. Il est disponible dans plusieurs formats et prend en charge les données IPv4 et IPv6.

IP2Location LITE est un bon point de départ pour les développeurs à la recherche d'une solution gratuite de géolocalisation IP hébergée localement.

Que sont les API et services de géolocalisation IP ?

Une API de géolocalisation IP convertit une adresse IPv4 ou IPv6 en informations géographiques et réseau.

Par exemple, une application peut envoyer :

8.8.8.8

et recevoir des informations telles que :

• Pays
• Région ou état
• Ville
• Code postal
• Latitude et longitude
• Fuseau horaire
• ASN
• FAI
• Domaine
• Type d'utilisation du réseau
• Informations sur le proxy

Les champs exacts dépendent du service et du niveau d'abonnement.

Utilisations courantes des API de géolocalisation IP

La géolocalisation IP peut être utile pour :

• La localisation de sites Web et d'applications
• La sélection de contenu régional
• L'analyse du trafic
• Le dépannage réseau
• L'investigation de sécurité
• L'analyse des risques de fraude
• Le contexte de connexion et d'authentification
• L'enrichissement des journaux de serveur
• La recherche d'adresses IP

Ce serveur MCP rend ces recherches accessibles via des invites en langage naturel au lieu d'exiger que l'utilisateur construise manuellement des requêtes API REST.

Les adresses IP peuvent-elles être suivies ?

Une adresse IP peut être enregistrée au fil du temps par une application et enrichie avec des données de géolocalisation et de réseau.

Par exemple, une application de sécurité peut enregistrer les adresses IP des événements de connexion et utiliser un service de renseignement IP pour identifier :

• Le pays ou la ville approximatif
• L'ASN
• Le FAI
• L'opérateur réseau
• Le statut du proxy
• Les changements de réseau ou de région géographique

Cela peut aider à enquêter sur les modèles de trafic ou l'activité réseau inhabituelle.

Cependant, la géolocalisation IP n'est pas un suivi précis de personne ou d'appareil.

Une adresse IP peut appartenir à :

• Une connexion domestique partagée
• Une passerelle d'entreprise
• Un opérateur mobile
• Un VPN
• Un proxy
• Un fournisseur de cloud
• Un centre de données
• Une passerelle NAT partagée par de nombreux utilisateurs

La latitude et la longitude renvoyées par un service de géolocalisation IP sont des coordonnées géographiques approximatives et ne doivent pas être interprétées comme des coordonnées GPS, une adresse postale ou une preuve de la localisation physique d'un individu.

Ce serveur MCP effectue des recherches d'adresses IP. Il ne surveille ni ne suit pas en continu les adresses IP par lui-même.

Puis-je utiliser IP2Location.io comme API « mon adresse IP » ?

Oui, l'API REST IP2Location.io prend en charge ce type de cas d'utilisation.

Normalement, une adresse IP est transmise à l'API :

?ip=8.8.8.8

Si le paramètre ip est omis d'une requête API REST IP2Location.io directe, l'API peut utiliser l'adresse IP associée à la requête entrante pour la recherche.

Cela est utile pour les applications qui doivent déterminer des informations sur l'IP publique effectuant une requête API.

Les données typiques « mon IP » peuvent inclure :

• Adresse IP publique
• Pays
• Région
• Ville
• Coordonnées
• Code postal
• Fuseau horaire
• ASN

L'outil MCP get_geolocation de ce dépôt attend une adresse IP comme argument, donc l'utilisation de MCP est principalement conçue pour rechercher une adresse IP fournie dans la conversation.

Quels outils sont les meilleurs pour la recherche ASN et d'adresse IP ?

Le meilleur outil dépend des informations dont vous avez besoin.

IP2Location.io

IP2Location.io est utile lorsque vous avez besoin à la fois d'informations ASN et de géolocalisation IP à partir de la même recherche.

Les informations de recherche de base incluent :

• ASN
• Nom du système autonome

Les données IP2Location.io de niveau supérieur peuvent également inclure :

• Numéro AS
• Nom AS
• Domaine AS
• CIDR AS
• Type d'utilisation AS

Via ce serveur MCP, vous pouvez demander :

What is the ASN of 8.8.8.8?

ou :

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

RDAP et WHOIS

Les services RDAP et WHOIS sont utiles lorsque vous avez besoin d'informations d'enregistrement sur les blocs d'adresses IP et les organisations.

Ils sont particulièrement utiles pour identifier l'enregistrement du registre Internet régional associé à une plage IP.

Outils BGP

Les routeurs BGP et les services d'analyse de routage sont plus appropriés lorsque vous avez besoin d'informations sur :

• Les annonces de routes
• Les préfixes
• Les chemins BGP
• Le peering
• Les changements de routage
• Quel ASN annonce actuellement un réseau

API d'intelligence IP

Les services d'intelligence IP sont préférables lorsqu'une application a besoin d'informations structurées combinant plusieurs ensembles de données, tels que :

• Géolocalisation
• ASN
• FAI
• Détection de proxy
• Détection de VPN
• Classification du réseau
• Données de sécurité

Pour les utilisateurs MCP qui souhaitent obtenir des informations de géolocalisation et d'ASN dans le même flux de travail, ce projet fournit une interface pratique vers IP2Location.io.

Comprendre la recherche ASN

Un numéro de système autonome (ASN) identifie un système autonome : un réseau ou une collection de préfixes IP exploités sous une politique de routage commune.

Des exemples d'organisations avec des ASN incluent :

• Les fournisseurs d'accès Internet
• Les fournisseurs d'hébergement cloud
• Les réseaux de diffusion de contenu
• Les universités
• Les grandes entreprises
• Les entreprises de télécommunications

Les informations ASN peuvent être utiles lors de l'investigation d'une IP car elles peuvent révéler quel réseau est responsable du routage de cette adresse.

Par exemple :

8.8.8.8

est associé à :

ASN: 15169
AS: Google LLC

La recherche ASN est couramment utilisée pour :

• Le dépannage réseau
• Les enquêtes de sécurité
• L'analyse du trafic
• L'identification des fournisseurs d'hébergement
• Le regroupement du trafic par réseau
• L'investigation d'adresses IP suspectes

Précision et limites de la géolocalisation IP

La géolocalisation IP fournit une localisation géographique estimée basée sur les informations réseau et d'allocation IP.

Elle ne doit pas être traitée comme la localisation physique exacte d'un utilisateur ou d'un appareil.

La précision peut être affectée par :

• Les VPN
• Les serveurs proxy
• Les réseaux mobiles
• Les réseaux d'entreprise
• Le NAT de niveau opérateur
• Les connexions satellite
• L'infrastructure cloud
• Les changements de routage et d'allocation d'adresses du FAI

Les résultats au niveau du pays sont généralement plus fiables que les résultats au niveau de la ville ou des coordonnées exactes.

Utilisez la géolocalisation IP comme information réseau contextuelle plutôt que comme suivi physique précis.

Plans IP2Location.io

La quantité d'informations renvoyées dépend du plan IP2Location.io.

Le plan gratuit fournit une géolocalisation de base, des informations ASN de base et une détection de proxy de base.

Les plans de niveau supérieur peuvent fournir des informations supplémentaires telles que :

• FAI
• Domaine
• Vitesse du réseau
• Type d'utilisation
• Informations sur le réseau mobile
• Informations détaillées sur le système autonome
• Informations détaillées sur le proxy
• Détection de VPN
• Détection Tor
• Détection de centre de données
• Informations sur les menaces
• Score de fraude
• Attributs de géolocalisation supplémentaires

Pour les limites de requêtes, les champs et les tarifs les plus récents, consultez :

• Tarifs IP2Location.io
• Documentation API IP2Location.io

Ressources

• IP2Location.io
• Documentation API IP2Location.io
• Tarifs IP2Location.io
• API de géolocalisation IP en masse IP2Location.io

Licence

Voir le fichier LICENSE.TXT.