IGN API Carto MCP Server

Serveur MCP (Model Context Protocol) pour interroger les données géographiques françaises via l'API Carto de l'IGN

📋 Table des matières

• À propos

• Fonctionnalités

• Prérequis

• Installation

• Configuration

• Utilisation

• Projets réalisés

• Exemples détaillés

• Format des géométries

• Limitations

• Sources de données

• Développement

• Dépannage

• Ressources

• Licence

À propos

Ce serveur MCP permet d'accéder aux riches données géographiques de l'IGN (Institut national de l'information géographique et forestière) directement depuis Claude Desktop ou tout autre client compatible MCP.

Il expose les principales API de l'écosystème IGN API Carto, permettant d'interroger des données cadastrales, agricoles, environnementales, d'urbanisme et administratives françaises en langage naturel.

Cas d'usage

• 🏘️ Analyser des données cadastrales et parcellaires

• 🌾 Consulter les déclarations agricoles (RPG)

• 🌳 Identifier les zones naturelles protégées

• 🏗️ Vérifier les règlements d'urbanisme (PLU, GPU)

• 🍷 Localiser les appellations viticoles

• 🗺️ Obtenir des données administratives géolocalisées

Fonctionnalités

Outils disponibles

Prérequis

• Node.js 16+ et npm

• Claude Desktop ou un client MCP compatible

• Connexion internet pour accéder aux API IGN

Installation

1. Cloner le dépôt

2. Installer les dépendances

3. Configurer les variables d'environnement

Éditez .env.local et ajoutez votre clé API IGN si vous souhaitez utiliser l'endpoint AOC viticoles :

4. Compiler le projet

Le serveur compilé sera disponible dans le dossier dist/.

Configuration

Configurez ce serveur MCP avec votre client IA préféré. Cliquez sur le client que vous utilisez pour voir les instructions détaillées.

Configuration Claude Desktop

Ajoutez la configuration suivante à votre fichier claude_desktop_config.json :

Emplacement du fichier :

Configuration :

⚠️ Important : Remplacez /chemin/absolu/vers/ par le chemin complet vers votre installation.

Configuration Claude Code

Claude Code utilise un fichier .mcp.json pour la configuration des serveurs MCP.

Configuration projet (recommandée) :

Créez un fichier .mcp.json à la racine de votre projet :

Configuration globale :

Pour une utilisation dans tous vos projets, créez le fichier dans ~/.claude/.mcp.json.

Activer le serveur :

Au premier lancement, Claude Code vous demandera d'approuver le serveur. Vous pouvez aussi l'activer automatiquement en ajoutant dans vos settings :

Ou spécifiquement :

Configuration Cursor

Cursor utilise un fichier mcp.json pour la configuration MCP.

Emplacement du fichier :

Configuration :

Avec variables d'environnement (optionnel) :

Activer le serveur :

1. Ouvrez les paramètres de Cursor (Cmd/Ctrl + ,)

2. Recherchez "MCP"

3. Activez les serveurs MCP

4. Redémarrez Cursor

Configuration Codex CLI

OpenAI Codex CLI supporte également le protocole MCP via un fichier de configuration.

Emplacement du fichier :

~/.codex/mcp.json

Configuration :

Note : Assurez-vous que Codex CLI est configuré pour utiliser les serveurs MCP. Consultez la documentation officielle Codex pour plus de détails sur l'activation des plugins MCP.

Configuration Google Antigravity

Google Antigravity est la plateforme de développement agentique de Google, disponible gratuitement en preview publique.

Accéder à la configuration MCP :

1. Cliquez sur Agent session dans le panneau latéral

2. Sélectionnez le menu "..." en haut du panneau

3. Cliquez sur MCP Servers → Manage MCP Servers

4. Sélectionnez View raw config pour éditer mcp_config.json

Configuration :

Mode HTTP (alternatif) :

Antigravity supporte également les serveurs MCP via HTTP/SSE :

Note : Antigravity limite le nombre total d'outils actifs. Si vous utilisez plusieurs serveurs MCP, gardez le total sous 50 outils pour des performances optimales.

Configuration générique

Ce serveur MCP est compatible avec tout client supportant le protocole MCP en mode stdio.

Paramètres de connexion :

Mode HTTP (alternatif) :

Pour les clients supportant HTTP/SSE, lancez le serveur en mode HTTP :

Puis configurez votre client avec l'URL : http://localhost:3000/mcp

Modes de transport

Le serveur supporte deux modes de communication :

Mode stdio (par défaut)

Mode standard pour une utilisation locale avec Claude Desktop :

Mode HTTP (optionnel)

Pour une utilisation en réseau ou depuis un client distant :

Variables d'environnement

Configurez le serveur via le fichier .env.local ou directement en ligne de commande :

Fichiers de configuration :

• .env.example : Template avec toutes les variables disponibles

• .env.local : Votre configuration locale (non versionné)

Utilisation

Une fois configuré dans Claude Desktop, vous pouvez interroger les données IGN en langage naturel. Le serveur traduira automatiquement vos requêtes en appels API appropriés.

Redémarrage après configuration

Après avoir modifié claude_desktop_config.json, redémarrez Claude Desktop pour que les changements soient pris en compte.

Projets réalisés

🍷 Analyse Territoriale de Margaux-Cantenac

Application interactive d'analyse territoriale pour la commune viticole de Margaux-Cantenac (Gironde), développée avec Claude et ce serveur MCP.

🔗

Fonctionnalités

L'application offre une analyse complète du territoire en 4 volets :

Technologies

• Interface React avec navigation par onglets

• Intégration de données IGN et INPN (Muséum National d'Histoire Naturelle)

• Visualisation géographique (bounding box, coordonnées précises)

• Codes couleur pour différencier les types de zones territoriales

Comment le reproduire ?

💡 Vous avez créé un projet avec ce serveur MCP ? Partagez-le en ouvrant une issue GitHub !

Exemples détaillés

1. Recherche par code postal

Question :

Réponse attendue :

• Liste des communes avec code INSEE

• Coordonnées géographiques

• Limites administratives

Outil utilisé : ign_get_communes_by_postal_code

2. Recherche de parcelles cadastrales

Question :

Paramètres possibles :

• Code INSEE de la commune

• Section cadastrale

• Numéro de parcelle

Outil utilisé : ign_get_cadastre_parcelles

3. Vérification du zonage d'urbanisme

Question :

Informations retournées :

• Type de zone (U, AU, A, N)

• Règlement d'urbanisme applicable

• Restrictions de constructibilité

• Date de mise à jour du PLU

Outil utilisé : ign_get_gpu_urbanisme

4. Zones naturelles protégées

Question :

Types de zones retournées :

• Sites Natura 2000 (ZSC, ZPS)

• ZNIEFF (type I et II)

• Parcs Nationaux et Régionaux

• Réserves naturelles

Outil utilisé : ign_get_nature_areas

5. Registre Parcellaire Graphique (agriculture)

Question :

Données disponibles :

• Type de culture

• Surface déclarée

• Code culture PAC

• Année de déclaration (2010-2024)

Outil utilisé : ign_get_rpg

6. Appellations viticoles

Note : Cet endpoint nécessite une clé API IGN gratuite. Obtenez-la sur geoservices.ign.fr

Question :

Informations retournées :

• Type d'appellation (AOC, IGP, VSIG)

• Nom de l'appellation

• Identifiant de l'appellation

• Géométrie de la zone

Outil utilisé : ign_get_aoc_viticoles

Configuration requise :

7. Limites administratives

Question :

Données disponibles :

• Limites communales

• Contours départementaux

• Contours régionaux

• Codes officiels géographiques

Outil utilisé : ign_get_administrative_limits

Format des géométries

Les géométries doivent être au format GeoJSON en WGS84 (EPSG:4326) :

Limitations

Limites des API IGN

Limitations fonctionnelles

• ⚠️ Le module WFS-Geoportail est en version beta

• Certaines données peuvent avoir un délai de mise à jour

• Les géométries complexes peuvent nécessiter une simplification

• Les données RPG sont disponibles de 2010 à 2024

Sources de données

Développement

Structure du projet

Scripts disponibles

Contribuer

Les contributions sont les bienvenues ! Pour contribuer :

1. Forkez le projet

2. Créez une branche pour votre fonctionnalité (git checkout -b feature/AmazingFeature)

3. Committez vos changements (git commit -m 'Add some AmazingFeature')

4. Pushez vers la branche (git push origin feature/AmazingFeature)

5. Ouvrez une Pull Request

Ajouter un nouvel outil

Pour ajouter un nouvel outil MCP :

1. Créez un nouveau fichier dans src/tools/

2. Définissez le schéma de l'outil avec ses paramètres

3. Implémentez la logique d'appel à l'API IGN

4. Enregistrez l'outil dans src/index.ts

5. Documentez l'outil dans ce README

Dépannage

Le serveur ne démarre pas

Vérifications :

• Node.js version 16+ est installé : node --version

• Les dépendances sont installées : npm install

• Le projet est compilé : npm run build

• Le fichier dist/index.js existe

Claude Desktop ne détecte pas le serveur

Solutions :

1. Vérifiez que le chemin dans claude_desktop_config.json est absolu et correct

2. Redémarrez complètement Claude Desktop

3. Vérifiez les logs de Claude Desktop :

   • macOS : ~/Library/Logs/Claude/

   • Windows : %APPDATA%\Claude\logs\

   • Linux : ~/.config/Claude/logs/

Erreurs d'API

Problèmes courants :

Problèmes de géométrie

Les géométries doivent être en WGS84 (EPSG:4326) avec longitude avant latitude :

Performances lentes

Optimisations :

• Utilisez des géométries simplifiées pour les grandes zones

• Limitez le nombre de résultats avec le paramètre _limit

• Utilisez des filtres spécifiques plutôt que des requêtes larges

• Vérifiez votre connexion internet

Ressources

Documentation officielle

• Documentation API Carto - Documentation complète des API

• Géoservices IGN - Portail des géoservices

• Model Context Protocol - Spécification MCP

• Claude Desktop - Application Claude Desktop

Outils utiles

• GeoJSON.io - Créer et visualiser des géométries GeoJSON

• Projections EPSG - Informations sur les systèmes de projection

• Géoportail - Visualiser les données IGN

Communauté

• Issues GitHub - Reporter un bug ou suggérer une fonctionnalité

• Discussions - Poser des questions

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Données IGN

Les données IGN sont soumises à la Licence Ouverte v2.0.

Développé avec ❤️ pour la communauté géospatiale française