8mn de lecture
Ce tutoriel vous explique pas à pas comment utiliser toutes les fonctionnalités de MonIP.lws.fr v2 : consulter votre adresse IP, utiliser l’API JSON dans vos projets, et connecter le serveur MCP à votre assistant IA. Aucune installation requise pour les fonctions de base.
Partie 1 — Utiliser MonIP.lws.fr
1.1 Accéder au site
Ouvrez votre navigateur et rendez-vous sur : https://monip.lws.fr
Votre adresse IP publique s’affiche immédiatement, accompagnée de la localisation approximative (ville, pays) et du type d’IP (IPv4/IPv6, publique).
1.2 Changer la langue
Cliquez sur le menu déroulant en haut à droite de la page (affichant par défaut « 🇫🇷 Français »).
Sélectionnez la langue de votre choix parmi les 10 disponibles. L’URL change en conséquence (ex : /en, /de, /es…), ce qui vous permet de partager directement un lien dans une langue précise.
1.3 Consulter les informations détaillées de votre IP
Cliquez sur le bouton « Informations détaillées » sous votre adresse IP. Vous obtenez :
- Adresse IP (IPv4 ou IPv6)
- Pays et code ISO
- Ville et région
- Fuseau horaire
- ASN (Autonomous System Number) — identifie le réseau
- FAI (Fournisseur d’Accès Internet)
- Nom d’hôte (reverse DNS, si disponible)
- Coordonnées GPS (précision ~50 km)
1.4 Rechercher une adresse IP tierce
Faites défiler jusqu’à la section « Chercher une IP ». Saisissez n’importe quelle adresse IPv4 ou IPv6 dans le champ de recherche et cliquez sur « Rechercher ». Les mêmes informations s’affichent pour l’IP interrogée.
1.5 Visualiser la localisation sur la carte
Cliquez sur « Localiser sur la carte » pour afficher la position géographique approximative de votre IP sur une carte OpenStreetMap. La précision est d’environ 50 km — suffisante pour identifier la ville ou la région, mais pas votre adresse exacte.
Partie 2 — Utiliser l’API JSON
2.1 Présentation de l’API
L’API de MonIP.lws.fr est une API REST publique, gratuite, sans inscription et sans clé. Elle retourne les informations d’une adresse IP au format JSON. Elle est accessible à l’adresse :
https://monip.lws.fr/api/{ip}
Remplacez {ip} par n’importe quelle adresse IPv4 ou IPv6 valide.
Rien de plus simple pour tester : ouvrez l’URL suivante directement dans votre navigateur :
https://monip.lws.fr/api/8.8.8.8
Vous obtenez une réponse JSON comme celle-ci :
{ "ip": "8.8.8.8", "version": 4, "is_private": false, "hostname": "dns.google", "country": "United States", "country_code": "US", "city": "Mountain View", "region": "California", "timezone": "America/Los_Angeles", "asn": "AS15169", "isp": "Google" }
2.3 Appel API avec cURL
Depuis un terminal, utilisez cURL :
curl https://monip.lws.fr/api/8.8.8.8
Pour une sortie JSON formatée, ajoutez un pipe vers jq (si installé) :
curl https://monip.lws.fr/api/8.8.8.8 | jq .
2.4 Intégration JavaScript (frontend)
Voici comment appeler l’API depuis une page web — le CORS étant activé, aucun proxy n’est nécessaire :
fetch('https://monip.lws.fr/api/1.1.1.1') .then(response => response.json()) .then(data => { console.log('Pays :', data.country); console.log('Ville :', data.city); console.log('FAI :', data.isp); });
2.5 Intégration PHP (backend)
<?php $ip = '8.8.8.8'; $url = "https://monip.lws.fr/api/{$ip}"; $data = json_decode(file_get_contents($url), true); echo $data['country']; // United States echo $data['isp']; // Google ?>
2.6 Gestion des erreurs
Si l’adresse IP fournie est invalide, l’API retourne une erreur HTTP 400 :
{ "error": "Invalid IP address" }
Vérifiez toujours que l’adresse IP fournie est au bon format avant d’appeler l’API dans votre code.
2.7 Référence des champs de réponse
|
Champ |
Type |
Description |
|
ip |
string |
Adresse IP interrogée |
|
version |
int |
Version protocole : 4 ou 6 |
|
is_private |
bool |
true si l’adresse est privée ou réservée |
|
hostname |
string|null |
Reverse DNS (PTR), null si absent |
|
country / country_code |
string|null |
Pays et code ISO 3166-1 alpha-2 |
|
city / region |
string|null |
Ville et subdivision administrative |
|
timezone |
string|null |
Fuseau horaire IANA |
|
latitude / longitude |
float|null |
Coordonnées GPS (~50 km de précision) |
|
asn / asn_org |
string|null |
Numéro AS et organisation propriétaire |
|
isp |
string|null |
Fournisseur d’accès internet |
Partie 3 — Connecter le Serveur MCP à votre Assistant IA
3.1 Qu’est-ce que MCP ?
MCP (Model Context Protocol) est un standard ouvert créé par Anthropic. Il permet aux assistants IA (Claude, Cursor, GitHub Copilot…) d’utiliser des outils externes en temps réel. Le serveur MCP MonIP expose 3 outils que votre IA peut appeler directement pendant une conversation.
3.2 URL du serveur MCP
https://monip.lws.fr/mcp/sse
3.3 Connexion depuis Claude.ai
Étape 1 : Allez dans Paramètres > Connecteurs > Ajouter un connecteur personnalisé.
Étape 2 : Dans le champ « Nom », saisissez : MonIP
Étape 3 : Dans le champ « URL du serveur MCP distant », saisissez : https://monip.lws.fr/mcp/sse
Étape 4 : Cliquez sur « Ajouter ». Le connecteur apparaît dans la liste et les 3 outils MonIP sont désormais disponibles dans toutes vos conversations Claude.
3.4 Connexion depuis Claude Desktop
Ouvrez le fichier de configuration de Claude Desktop (claude_desktop_config.json) et ajoutez le bloc suivant dans la section mcpServers :
{ "mcpServers": { "monip": { "type": "url", "url": "https://monip.lws.fr/mcp/sse" } } }
Sauvegardez le fichier et relancez Claude Desktop. Les outils MonIP apparaissent dans le panneau des outils disponibles.
3.5 Connexion depuis Cursor
Dans votre projet, créez ou éditez le fichier .cursor/mcp.json :
{ "mcpServers": { "monip": { "url": "https://monip.lws.fr/mcp/sse" } } }
Redémarrez Cursor. L’agent IA du projet peut désormais appeler les outils MonIP.
3.6 Les 3 outils MCP disponibles
|
Outil |
Paramètre |
Description |
|
ip_lookup |
ip (string) |
Lookup complet : pays, ville, GPS, FAI, ASN, hostname |
|
ip_geolocate |
ip (string) |
Localisation rapide en une ligne — idéal pour un aperçu |
|
ip_validate |
ip (string) |
Valide une IP : version (4/6), publique ou privée |
3.7 Exemples de questions à poser à votre IA
- « Localise l’IP 185.42.116.0 » → ip_lookup : pays, ville, FAI, coordonnées GPS
- « Est-ce que 10.0.0.1 est une IP valide et publique ? » → ip_validate : IPv4 privée
- « Où se trouve le serveur Cloudflare 1.1.1.1 ? » → ip_geolocate : San Jose, US
- « Quel ASN correspond à l’IP 217.70.184.38 ? » → ip_lookup : ASN + organisation
3.8 Tester le serveur MCP avec cURL
Pour vérifier que le serveur MCP fonctionne correctement, exécutez cette commande :
curl -X POST https://monip.lws.fr/mcp/sse \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ip_lookup","arguments":{"ip":"8.8.8.8"}}}'
Vous devriez recevoir une réponse JSON avec les informations complètes sur l’IP 8.8.8.8.
FAQ — Questions fréquentes
L’API est-elle vraiment gratuite et sans limite ?
L’API est gratuite et ne nécessite aucune clé. Un usage raisonnable est requis — elle n’est pas dimensionnée pour des volumes industriels (millions de requêtes/jour). Pour des besoins massifs, contactez-nous.
Mes données sont-elles collectées ?
MonIP.lws.fr n’enregistre pas les adresses IP recherchées. Les résultats sont mis en cache pendant 1 heure pour des raisons de performance, mais aucun journal nominatif n’est conservé.
Le serveur MCP est-il open source ?
Oui, l’implémentation est en pur PHP et le code source est disponible sur demande. N’hésitez pas à nous contacter si vous souhaitez l’adapter ou l’héberger vous-même.
L’API fonctionne-t-elle avec IPv6 ?
Oui. L’API accepte les adresses IPv4 et IPv6 indifféremment. Exemple : monip.lws.fr/api/2001:4860:4860::8888 pour le DNS IPv6 de Google.
Commentaires (0)