Geocontext MCP server
Commit 13 Nov 2026Memungkinkan AI assistant untuk melakukan query data referensi geografis resmi Prancis dari IGN Géoplateforme, termasuk data geocoding, ketinggian, cadastre, dan urbanisme.
Juga dikenal sebagai ignfab/geocontext
- Stars
- 32
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 13 Nov 2026
- Lisensi
- MIT
Apa itu Geocontext MCP?
Geocontext adalah MCP server. Memungkinkan AI assistant untuk melakukan query data referensi geografis resmi Prancis dari IGN Géoplateforme, termasuk data geocoding, ketinggian, cadastre, dan urbanisme.
Ringkasan dibuat dari README proyek
Tentang Geocontext MCP server
Geocontext memungkinkan Anda melakukan query data geografis resmi Prancis secara langsung melalui AI assistant. Tool ini menghubungkan large language model ke IGN Géoplateforme, memberikan akses ke dataset otoritatif tanpa perlu mengunduh data secara lokal atau melakukan sinkronisasi data manual. MCP server ini dirancang untuk mengurangi halusinasi dengan menyediakan respon yang dioptimalkan dan schema yang diperkaya untuk membantu model mengidentifikasi field dan properti yang benar.
Developer dapat menggunakan server ini secara lokal via npx atau terhubung ke instance HTTP jarak jauh. Tool ini bekerja dengan client yang kompatibel dengan MCP seperti Claude Desktop, Cursor, atau antarmuka web seperti ChatGPT dan Mistral Vibe. Toolset ini mencakup command spesifik seperti geocode untuk mencari lokasi, altitude untuk data ketinggian, dan cadastre untuk informasi parsel. Tool ini juga mendukung query kompleks melalui gpf_count_features dan pengambilan data urbanisme via tool urbanisme, menjadikannya sumber daya khusus bagi siapa pun yang membutuhkan konteks spasial Prancis yang presisi.
Apa yang bisa Anda lakukan dengannya
- 1Menghitung tipe bangunan tertentuMinta AI untuk menghitung berapa banyak bangunan di kota tertentu yang melebihi ketinggian tertentu.
- 2Mengambil informasi administratifMinta detail administratif untuk landmark terkenal guna mengidentifikasi commune atau departemennya.
- 3Menganalisis dokumen perencanaan kotaIdentifikasi regulasi urbanisme lokal seperti PLU untuk pelabuhan atau area tertentu.
- 4Menghitung aksesibilitas perjalananTemukan fasilitas lokal seperti sekolah yang dapat dijangkau dalam waktu berjalan kaki tertentu dari stasiun metro.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauignfab/geocontext is public and reachablegithub.com/ignfab/geocontext ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/ignfab/geocontext ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubGeocontext
Geocontext est un serveur MCP qui permet aux assistants IA d’interroger les données géographiques françaises de référence publiées sur la Géoplateforme de l'IGN.
Pourquoi Geocontext ?
- Pas de téléchargement — Geocontext interroge directement les services de la Géoplateforme IGN, sans copie locale ni synchronisation à maintenir.
- Données de référence à jour — les réponses s’appuient sur les référentiels géographiques publiés en continu par l’IGN et ses partenaires.
- Réponses optimisées pour les LLM — les traitements et filtrages sont faits côté serveur pour limiter les tokens transmis au modèle.
- Moins d’hallucinations — les descriptions et schémas enrichis aident l’assistant à identifier les bonnes données et les bons champs (implémentation anticipée de OGC API Feature - schema dans ignfab/gpf-schema-store).
- Compatible MCP — utilisable avec des clients compatibles MCP comme Claude Desktop ou Cursor, mais aussi directement dans certaines interfaces de chat en ligne compatibles, comme Claude, Mistral Vibe ou ChatGPT, via leurs connecteurs MCP.
Démo en 30 secondes
Question
Combien y a-t-il de bâtiments de plus de 20 mètres à Vincennes ?
Réponse
À Vincennes (94300, Val-de-Marne), il y a 509 bâtiments de plus de 20 mètres de hauteur, selon les données de la BD TOPO® de l'IGN.
La hauteur prise en compte est celle mesurée entre le sol et le point haut de la gouttière du bâtiment.
Trace complète
💬 Je vais d'abord rechercher les informations nécessaires :
les coordonnées de Vincennes et le type GPF pour les bâtiments.
🔧 Appel outil: geocode({'text': 'Vincennes'})
🔧 Appel outil: gpf_search_types({'query': 'bâtiment hauteur'})
💬 Parfait ! J'ai trouvé le type GPF BDTOPO_V3:batiment.
Je vais maintenant récupérer le schéma de ce type pour connaître
les propriétés exactes, notamment la hauteur et le code INSEE de Vincennes.
🔧 Appel outil: gpf_describe_type({'typename': 'BDTOPO_V3:batiment'})
🔧 Appel outil: adminexpress({'lon': 2.437785,'lat': 48.847279})
💬 J'ai toutes les informations nécessaires.
La commune de Vincennes a le feature_id commune.33667.
Je vais maintenant compter les bâtiments de plus de 20 mètres
de hauteur sur cette commune.
🔧 Appel outil: gpf_count_features({
'typename': 'BDTOPO_V3:batiment',
'where': [
{
'property': 'hauteur',
'operator': 'gt',
'value': '20'
}
],
'intersects_feature_filter': {
'typename': 'ADMINEXPRESS-COG.LATEST:commune',
'feature_id': 'commune.33667'
}
})
💬 À Vincennes (`94300`, Val-de-Marne), il y a **509 bâtiments**
de plus de **20 mètres de hauteur**, selon les données
de la **BD TOPO®** de l'IGN.
La hauteur prise en compte est celle mesurée entre le sol
et le point haut de la gouttière du bâtiment.
Démarrage rapide
☁️ Instance HTTP prête à l'emploi
Geocontext est disponible comme serveur MCP distant en HTTP : https://geollm.beta.ign.fr/geocontext/mcp
Exemple de configuration pour un client compatible MCP acceptant les serveurs HTTP distants :
{
"mcpServers": {
"geocontext": {
"type": "http",
"url": "https://geollm.beta.ign.fr/geocontext/mcp"
}
}
}
Selon le client utilisé, la syntaxe exacte peut varier. Certaines interfaces de chat compatibles MCP demandent simplement l’URL du serveur distant dans leurs paramètres de connecteurs.
💻 Utilisation en local
Prérequis : Node.js (
>=22.21.0 <23,>=24.5.0recommandé, à contrôler avecnode --version) avecnpx.
Vous pouvez lancer Geocontext vous-même en local avec la commande npx -y @ignfab/geocontext qui démarrera la dernière version publiée de @ignfab/geocontext ou laisser un client MCP comme Cursor le démarrer pour vous via sa configuration.
Par exemple, dans Cursor ("Settings" > "MCP" > "Add server"):
{
"mcpServers": {
"geocontext": {
"command": "npx",
"args": ["-y", "@ignfab/geocontext"]
}
}
}
Exemples d’utilisation
Géocodage et altimétrie
ADMIN-EXPRESS et CADASTRE
BDTOPO
Isochrone
Géoportail de l'Urbanisme
Fonctionnalités disponibles
Les fonctionnalités correspondent aux outils MCP documentés dans docs/mcp-tools.md.
| Usage | Outil MCP | Source utilisée | Exemple |
|---|---|---|---|
| Géocoder un lieu | geocode |
Autocomplétion Géoplateforme | Localiser une mairie |
| Obtenir une altitude | altitude |
Calcul altimétrique Géoplateforme | Altitude d'un point |
| Calculer une distance ou un temps de trajet | distance |
Calcul d'itinéraire Géoplateforme | Temps de trajet à pied |
| Récupérer le contexte administratif | adminexpress |
WFS + ADMIN-EXPRESS | Commune, département, région |
| Récupérer le cadastre | cadastre |
WFS + PARCELLAIRE-EXPRESS | Parcelle cadastrale |
| Récupérer les documents d'urbanisme | urbanisme |
WFS + données GPU | PLU, POS, CC |
| Récupérer les servitudes | assiette_sup |
WFS + données GPU | SUP autour d'un lieu |
| Trouver une couche GPF | gpf_search_types |
gpf-schema-store | Trouver la table des bâtiments |
| Décrire une couche GPF | gpf_describe_type |
gpf-schema-store | Lister les champs disponibles |
| Interroger une couche GPF | gpf_get_features |
WFS + isochrone | Extraire des objets |
| Compter les objets résultats d'une interrogation de couche GPF | gpf_count_features |
WFS | Compter les bâtiments d'une zone |
| Récupérer un objet par identifiant | gpf_get_feature_by_id |
WFS | Charger une commune précise |
| Télécharger le résultat d'une interrogation de couche GPF | gpf_get_features_layer |
WFS + isochrone | Cartographier un résultat |
| Télécharger un objet par identifiant | gpf_get_feature_by_id_layer |
WFS | Cartographier un objet |
Architecture en bref
Geocontext agit comme un intermédiaire entre un assistant compatible MCP et les services de la Géoplateforme IGN.
Il n’héberge pas les données : il expose des outils MCP, interroge les services IGN à la demande, puis retourne au LLM des réponses structurées, filtrées et adaptées à son contexte.
flowchart TB
assistant["Assistant IA / client MCP"]
geocontext["Geocontext<br/>serveur MCP"]
geopf["Géoplateforme IGN<br/>géocodage · altimétrie · WFS · urbanisme · cadastre"]
assistant -->|"appels d'outils MCP"| geocontext
geocontext -->|"requêtes aux services IGN"| geopf
geopf -->|"données de référence"| geocontext
geocontext -->|"réponses structurées"| assistant
En pratique, Geocontext permet à l’assistant de passer d’une question en langage naturel à des appels aux données géographiques de référence, sans téléchargement préalable ni copie locale des référentiels.
Statut et limites
- 🧪 Ce projet est un prototype en incubation au sein d'IGNfab, basé sur un prototype antérieur désormais archivé. S'il s'avère pertinent de l'industrialiser, il sera migré vers l'organisation IGN principale (ex. :
IGNF/mcp-gpf-server). - 🪄 Cet outil n'est pas magique : ses capacités sont strictement définies et documentées dans la section Fonctionnalités.
Documentation
La documentation détaillée est répartie par usage :
-
Installer Geocontext dans un client MCP
-
Configurer le serveur MCP
- Configuration avancée : proxy d’entreprise, modes de transport
stdio/http, paramètres d’exécution.
- Configuration avancée : proxy d’entreprise, modes de transport
-
Comprendre les outils disponibles
- Outils MCP : description technique des outils exposés par Geocontext, paramètres attendus et exemples d’appels.
-
Développer ou contribuer au code
- Guide développeur : installation des dépendances, construction de l’application, exécution des tests et organisation du projet.
Contribution
🐛 Signaler un problème
N'hésitez pas à créer une issue si vous rencontrez un problème !
Merci de fournir :
- Le client MCP (ex. : GitHub Copilot, Cursor, Claude Desktop) et le mode de transport (stdio ou http) utilisé.
- Le modèle utilisé (ex. : Claude Sonnet 4.5)
- La version de Geocontext (visible sur npmjs.com/@ignfab/geocontext)
- La demande faite à l'assistant (ex. : "Combien y a-t-il de ponts franchissant la Seine ?")
- Si possible, un export de la discussion au format Markdown.
✨ Demander une évolution
N'hésitez pas non plus à créer une issue pour demander une évolution.
Merci de fournir la question type pour laquelle vous souhaiteriez que le MCP aide à apporter une réponse. Par exemple :
- "Quels sont les fonds de carte disponibles ?" -> nous verrons comment exploiter le service WMTS de la Géoplateforme.
Crédits
- mcp-framework : cadre de développement du MCP
- @ignfab/gpf-schema-store : couche sémantique / catalogue de schémas embarqué (en attendant OGC API - Features - schema)
- @camptocamp/ogc-client : exploration WFS (ex. : parsing GetCapabilities)
- MiniSearch : recherche par mot-clé (
gpf_search_types)
- jsts : traitements géométriques (ex. : tri des réponses par distance au point recherché).
- turfjs/distance : calculs de distance avec la formule de Haversine.
Voir également
- https://github.com/datagouv/datagouv-mcp : MCP data.gouv.fr
Exemple : Qui est le maire de la commune de Vincennes ?
- https://git.tricoteuses.fr/logiciels/tricoteuses-api-parlement : MCP parlement français non officiel
- https://github.com/datagouv/datagouv-skill : Skills data.gouv.fr
Licence
Pertanyaan tentang Geocontext MCP
Data geografis apa saja yang bisa disediakan Geocontext untuk Prancis?
Geocontext memberikan akses ke data referensi IGN seperti geocoding, ketinggian, routing, batas administratif ADMIN-EXPRESS, parsel cadastre, dokumen urbanisme (PLU), dan SUP servitudes. Tool ini juga melakukan query layer GPF melalui WFS.
Bisakah saya menjalankan Geocontext secara lokal?
Ya, Anda bisa menjalankannya dengan npx -y @ignfab/geocontext pada Node.js, atau biarkan client seperti Cursor memulainya melalui konfigurasi. Diperlukan Node.js versi 22.21+ atau 24.5+.
Client AI mana saja yang kompatibel dengan Geocontext?
Tool ini bekerja dengan client yang kompatibel dengan MCP seperti Claude Desktop dan Cursor, serta antarmuka chat online yang mendukung connector MCP, seperti Claude, Mistral Vibe, atau ChatGPT.
Apakah Geocontext mengunduh atau menyimpan data geografis secara lokal?
Tidak, Geocontext melakukan query langsung ke layanan IGN Géoplateforme tanpa salinan lokal atau sinkronisasi. Respon difilter di sisi server untuk mengurangi jumlah token yang dikirim ke model.