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

Outil	Description	Cas d'usage
ign_get_communes_by_postal_code	Récupérer les communes associées à un code postal	Résolution d'adresses, statistiques postales
ign_get_cadastre_parcelles	Rechercher des parcelles cadastrales	Études foncières, analyse immobilière
ign_get_cadastre_communes	Obtenir les limites communales cadastrales	Délimitation territoriale, cartographie
ign_get_rpg	Interroger le Registre Parcellaire Graphique	Analyse agricole, environnement
ign_get_nature_areas	Espaces naturels protégés (Natura 2000, ZNIEFF, parcs)	Études environnementales, biodiversité
ign_get_gpu_urbanisme	Données d'urbanisme du Géoportail de l'Urbanisme	Vérification PLU, constructibilité
ign_get_aoc_viticoles	Zones d'appellations viticoles (AOC, IGP, VSIG)	Viticulture, géomarketing
ign_wfs_geoportail	Accès générique aux flux WFS du Géoportail	Données géographiques diverses
ign_get_administrative_limits	Limites administratives (communes, départements, régions)	Découpage territorial, statistiques

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

git clone https://github.com/votre-utilisateur/ign-apicarto-mcp-server.git
cd ign-apicarto-mcp-server

2. Installer les dépendances

npm install

3. Configurer les variables d'environnement

# Copier le fichier d'exemple
cp .env.example .env.local

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

# Obtenir une clé gratuite : https://geoservices.ign.fr/
IGN_API_KEY=votre_cle_api

4. Compiler le projet

npm run build

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.

<details> <summary><strong>🖥️ Claude Desktop</strong></summary>

Configuration Claude Desktop

Ajoutez la configuration suivante à votre fichier claude_desktop_config.json :

Emplacement du fichier :

Système	Chemin
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Configuration :

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

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

</details>

<details> <summary><strong>⌨️ Claude Code (CLI)</strong></summary>

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 :

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

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 :

{
  "enableAllProjectMcpServers": true
}

Ou spécifiquement :

{
  "enabledMcpjsonServers": ["ign-apicarto"]
}

</details>

<details> <summary><strong>📝 Cursor</strong></summary>

Configuration Cursor

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

Emplacement du fichier :

Portée	Chemin
Projet	.cursor/mcp.json (à la racine du projet)
Global	~/.cursor/mcp.json

Configuration :

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

Avec variables d'environnement (optionnel) :

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["${workspaceFolder}/ign-apicarto-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Activer le serveur :

1. Ouvrez les paramètres de Cursor (Cmd/Ctrl + ,)
2. Recherchez "MCP"
3. Activez les serveurs MCP
4. Redémarrez Cursor

</details>

<details> <summary><strong>🤖 OpenAI Codex CLI</strong></summary>

Configuration Codex CLI

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

Emplacement du fichier :

~/.codex/mcp.json

Configuration :

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

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.

</details>

<details> <summary><strong>🚀 Google Antigravity</strong></summary>

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 :

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

Mode HTTP (alternatif) :

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

{
  "mcpServers": {
    "ign-apicarto": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

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.

</details>

<details> <summary><strong>🔧 Autres clients MCP</strong></summary>

Configuration générique

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

Paramètres de connexion :

Paramètre	Valeur
Transport	stdio
Commande	node
Arguments	["/chemin/vers/dist/index.js"]

Mode HTTP (alternatif) :

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

TRANSPORT=http PORT=3000 npm start

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

</details>

Modes de transport

Le serveur supporte deux modes de communication :

Mode stdio (par défaut)

Mode standard pour une utilisation locale avec Claude Desktop :

npm start

Mode HTTP (optionnel)

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

TRANSPORT=http PORT=3000 npm start

Variables d'environnement

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

Variable	Description	Défaut
TRANSPORT	Mode de transport (stdio ou http)	stdio
PORT	Port HTTP (mode HTTP uniquement)	3000
IGN_API_KEY	Clé API IGN pour l'endpoint AOC viticoles	-

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.

🔗 Voir la démo interactive

Fonctionnalités

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

Module	Contenu	APIs utilisées
📍 Vue générale	Code INSEE, coordonnées WGS84, contexte viticole	ign_get_communes_by_postal_code, ign_get_administrative_limits
🏗️ Urbanisme	Plan Local d'Urbanisme avec 52 zones (A, U, N, AU)	ign_get_gpu_urbanisme
🌳 Environnement	Parc Naturel Régional du Médoc, zones ZNIEFF	ign_get_nature_areas
📐 Cadastre	Sections cadastrales, identifiants de parcelles	ign_get_cadastre_parcelles, ign_get_cadastre_communes

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 ?

Créé une application React interactive pour analyser le territoire de la commune
de Margaux-Cantenac. Utilise les données IGN pour afficher :
- Les informations administratives
- Le zonage PLU complet
- Les zones naturelles protégées
- Les sections cadastrales

L'interface doit être organisée en onglets avec une navigation fluide.

---

💡 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 :

Quelles communes sont associées au code postal 75001 ?

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 :

Trouve les parcelles cadastrales de la commune avec le code INSEE 75101

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 :

Quel est le zonage PLU à ces coordonnées : {"type":"Point","coordinates":[2.35,48.85]} ?

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 :

Y a-t-il des zones Natura 2000 à proximité de ce point : {"type":"Point","coordinates":[-1.69,48.10]} ?

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 :

Quelles cultures sont déclarées sur cette parcelle agricole en 2023 ?
Géométrie : {"type":"Point","coordinates":[2.35,45.85]}

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 :

Cette parcelle est-elle située dans une AOC viticole ?
Coordonnées : {"type":"Point","coordinates":[4.84,45.76]}

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 :

# Dans .env.local
IGN_API_KEY=votre_cle_api

---

7. Limites administratives

Question :

Dans quel département et quelle région se trouve la commune de Lyon ?

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) :

// Point
{"type":"Point","coordinates":[longitude, latitude]}

// Polygon
{"type":"Polygon","coordinates":[[[lon1,lat1],[lon2,lat2],[lon3,lat3],[lon1,lat1]]]}

// MultiPolygon
{"type":"MultiPolygon","coordinates":[[[[lon1,lat1],[lon2,lat2],...]],[...]]}

Limitations

Limites des API IGN

Type	Limite
Résultats max par requête	1000 (500 pour communes cadastrales)
Pagination	Disponible via _start et _limit
Projection géographique	WGS84 (EPSG:4326) uniquement
Timeout requête	30 secondes
Format de sortie	GeoJSON

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

Source	Données	Organisme	Mise à jour
PCI Express	Cadastre parcellaire	DGFiP	Annuelle
BD Parcellaire	Limites cadastrales	IGN	Trimestrielle
RPG	Registre Parcellaire Graphique	ASP	Annuelle
MNHN	Espaces naturels protégés	Muséum National d'Histoire Naturelle	Variable
GPU	Plans locaux d'urbanisme	Géoportail de l'Urbanisme	Continue
FranceAgriMer	Appellations viticoles	INAO	Annuelle
BAN	Base Adresse Nationale	IGN / La Poste	Hebdomadaire

Développement

Structure du projet

ign-apicarto-mcp-server/
├── src/
│   ├── index.ts          # Point d'entrée du serveur MCP
│   ├── api-client.ts     # Client HTTP pour l'API IGN
│   └── types.ts          # Types TypeScript
├── dist/                 # Fichiers compilés
├── .env.example          # Template des variables d'environnement
├── .env.local            # Configuration locale (non versionné)
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

Scripts disponibles

# Démarrer le serveur en mode développement
npm run dev

# Compiler le projet
npm run build

# Démarrer le serveur en production
npm start

# Lancer les tests (si disponibles)
npm test

# Vérifier le code
npm run lint

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 :

Erreur	Cause	Solution
Timeout	Requête trop complexe	Simplifier la géométrie ou réduire la zone
400 Bad Request	Paramètres invalides	Vérifier le format GeoJSON
404 Not Found	Données non disponibles	Vérifier les codes INSEE/postaux
500 Server Error	Problème côté IGN	Réessayer plus tard
Too many results	Plus de 1000 résultats	Ajouter des filtres ou paginer

Problèmes de géométrie

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

✅ Correct : {"type":"Point","coordinates":[2.35, 48.85]}
❌ Incorrect : {"type":"Point","coordinates":[48.85, 2.35]}

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