IP2Location.io MCP Server

officiel

Intégration de l'API IP2Location.io pour récupérer les informations de géolocalisation d'une adresse IP.

Documentation

Serveur MCP IP2Location.io

Il s'agit d'une implémentation simple de serveur Model Context Protocol (MCP) pour l'API IP2Location.io. Elle renvoie des informations de géolocalisation détaillées pour toute adresse IPv4 ou IPv6 donnée.

Fonctionnalités

Données de géolocalisation complètes : Récupère un large éventail d'informations, notamment le pays, la région, la ville, la latitude, la longitude, le code postal, le fuseau horaire et plus encore.
Détails réseau : Fournit des données relatives au réseau telles que l'ASN, le FAI, le domaine et la vitesse du réseau.
Informations de sécurité : Détecte les informations de proxy, y compris le type de proxy et le fournisseur.
Intégration simple : Conçu comme un outil FastMCP, permettant une intégration facile dans les systèmes compatibles.
Asynchrone : Utilise httpx pour des requêtes API asynchrones non bloquantes.

Prérequis

Ce serveur MCP prend en charge les requêtes sans clé API, avec une limite de 1 000 requêtes par jour. Vous pouvez également vous inscrire pour obtenir une clé API gratuite et bénéficier de jusqu'à 50 000 requêtes par mois.

Si vous utilisez le serveur MCP hébergé dans le cloud, vous n'avez besoin que de Claude Desktop et de npx, car le serveur est hébergé à distance. Si vous souhaitez exécuter le serveur MCP original localement, la configuration locale utilise uv, qui peut être installé en suivant le guide.

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 original sur votre propre machine.

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

Suivez les étapes ci-dessous pour utiliser le serveur MCP IP2Location.io hébergé dans le cloud avec Claude Desktop :

Assurez-vous d'avoir installé Claude Desktop. Si vous ne l'avez pas encore installé, téléchargez-le depuis ici pour Windows et macOS, ou suivez ce guide pour les utilisateurs Linux.
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.
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"
      ]
    }
  }
}

Remplacez YOUR_API_KEY par votre clé API IP2Location.io réelle. Pour obtenir votre clé API, connectez-vous à votre tableau de bord.
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 les étapes ci-dessous si vous souhaitez exécuter le serveur MCP original localement avec Claude Desktop :

Configurez le gestionnaire de paquets uv. Vous pouvez vous référer à ce guide pour le faire.
Assurez-vous d'avoir installé Claude Desktop. Si vous ne l'avez pas encore installé, téléchargez-le depuis ici pour Windows et macOS, ou suivez ce guide pour les utilisateurs Linux.
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.
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>"
      }
    }
  }
}

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.
Redémarrez Claude Desktop après avoir enregistré les modifications, et vous devriez le voir apparaître dans le menu Connectors.

Utilisation

Saisissez simplement votre requête concernant l'IP dans une conversation dans Claude Desktop. Voici quelques exemples de requêtes :

Où se trouve l'emplacement de (IP) ?
Où est située (IP) ?
Quelles sont les coordonnées de (IP) ?

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

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

Vous pouvez également utiliser l'API de géolocalisation IP en masse IP2Location.io pour interroger plusieurs adresses IP. Saisissez simplement toutes les adresses IP avec un espace entre chaque adresse IP. Par exemple 8.8.8.8 8.8.6.6.

[!REMARQUE]
L'API de géolocalisation IP en masse IP2Location.io nécessite un forfait payant pour fonctionner.

Variable d'environnement

IP2LOCATION_API_KEY

La clé API IP2Location.io, qui vous permet d'interroger jusqu'à 50 000 fois par mois et d'obtenir plus de détails sur l'adresse IP. Vous pouvez vous inscrire pour une clé API gratuite, ou souscrire à un forfait pour bénéficier de plus d'avantages.

Outil

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 à obtenir 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 en masse IP2Location.io pour un traitement efficace lorsque plusieurs IP sont détectées.

Arguments

ip (str) : L'adresse IP (IPv4 ou IPv6) à analyser. Vous pouvez interroger plusieurs IP à la fois en les passant sous forme de chaîne unique séparée par des virgules, des espaces ou des sauts de ligne (par exemple, "1.1.1.1, 2.2.2.2").

Renvoie 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. Le résultat peut inclure les champs suivants, selon votre forfait API :

Localisation et géographie : Pays, région, district, ville, code postal, latitude et longitude, fuseau horaire.
Réseau et connectivité : ASN (numéro de système autonome), FAI (fournisseur d'accès Internet), domaine, vitesse du réseau, code IDD, indicatif régional, type d'adresse, type d'utilisation.
Informations mobiles : MNC (code de réseau mobile), MCC (code de pays mobile), marque mobile.
Devise et langue : code de devise, nom de la devise, symbole de la devise, code de langue, nom de la langue.
Proxy et sécurité : type de proxy, dernière observation, niveau/type de menace, fournisseur de proxy, score de fraude.
Autres : catégorie IAB, météo, altitude, population, et plus encore.

Si une requête 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 ayant échoué renverra un objet d'erreur mappé à cette adresse IP spécifique sans faire échouer l'ensemble du lot.

Licence

Voir le fichier LICENSE.