Provides spatial context for LLMs by integrating with French geographic data services, including geocoding, altitude calculation, administrative boundaries (AdminExpress), cadastral information, urban planning documents, and WFS data exploration from the Géoplateforme.
Supports deployment via Docker Compose for running the geocontext MCP server.
geocontext
Un serveur MCP expérimental fournissant du contexte spatial pour les LLM.
Motivation
Les LLM renforcent l'idée que la magie est possible avec l'informatique. Il n'en est rien. Pour qu'un assistant soit en mesure de connaître la date et l'heure, il faut par exemple l'interfacer avec un MCP time. De même, pour qu'il soit en mesure de lire une page, il faut par exemple l'interfacer un MCP fetch.
En matière de données géographique, si un utilisateur pose une question impliquant que l'assistant soit en mesure de connaître la position d'une adresse, il y a de bonne chance que la réponse soit plausible mais fausse.
S'il est techniquement possible de brancher des API REST/GeoJSON telle APICARTO, la conception de ces dernières n'est pas adaptée (5000 résultat par défaut, grosse géométrie dans les réponses, géométries complexes à fournir,...).
L'idée est ici d'expérimenter la conception d'un MCP rendant les données et les services de la Géoplateforme accessibles par un LLM.
Mises en garde
Ce développement est un POC en incubation avec IgnFab (archivage en cours de mborne/geocontext)
S'il s'avère utile de l'industrialiser, le dépôt sera migré sous responsabilité IGN et l'outil sera renommé (ex :
IGNF/mcp-gpf-server)Plusieurs problèmes et améliorations possibles ont été identifiés et sont en cours de mitigation/résolution (c.f. issues).
Cet outil n'est pas magique (voir Fonctionnalités pour avoir une idée de ses capacités)
Principes de conception
Ne pas copier les données de la Géoplateforme (but : identifier les améliorations possibles sur le services plutôt que les doublonner)
Limiter au maximum la taille des réponses (but : optimiser le nombre de jeton / éviter les hallucinations / pouvoir utiliser des modèles locaux)
...
Utilisation
Utilisation de la version publiée
Par exemple, avec "Cursor Settings / MCP / Add server" :
Utilisation avec Docker
Ensuite :
Développement
Construction de la version locale
Utilisation de la version locale
Debug de la version locale
Paramétrage
Pour une utilisation avancée :
Nom | Description | Valeur par défaut |
| permet de choisir entre "stdio" et "http" | "stdio" |
Fonctionnalités
Utiliser des services spatiaux
Quelques services de la Géoplateforme :
geocode(text) s'appuie sur le service d’autocomplétion de la Géoplateforme pour convertir un nom de lieu en position (lon,lat).
Ex : Quelle est la position (lon,lat) de la mairie de Vincennes?
altitude(lon,lat) s'appuie sur le service de calcul altimétrique de la Géoplateforme pour convertir une position en altitude.
Ex : Quelle est l'altitude de la mairie de Loray (25)?
Recherche d'informations pour un lieu
L'idée est ici de répondre à des précises en traitant côté serveur les appels aux services WFS de la Géoplateforme :
adminexpress(lon,lat) permet de récupérer les informations administratives (commune, département, région,...) pour un lieu donné par sa position.
Ex : Quelles sont les informations administrative pour la mairie de Vincennes?
cadastre(lon,lat) permet de récupérer les informations cadastrales (parcelle, feuille,...).
Ex : Quelles sont les informations du cadastre pour la mairie de Vincennes?
urbanisme(lon,lat) permet de récupérer les informations d'urbanisme (PLU,POS,CC,PSMV)
Ex : Quel est le document PLU en vigueur pour le port de Marseille?
assiette_sup(lon,lat) permet de récupérer les Servitude d'Utilité Publiques (SUP)
Explorer les données vecteurs
Explorer les tables
gpf_wfs_list_types() pour lister les tables disponibles sur le WFS de la Géoplateforme (GetCapabilities) - déprécié (trop de résultats)
gpf_wfs_search_types(keywords,max_results=10) pour rechercher les tables disponibles sur le WFS de la Géoplateforme (GetCapabilities)
Quels sont les millésimes ADMINEXPRESS disponibles sur la Géoplateforme?
Quelle est la table de la BDTOPO correspondant aux bâtiments?
Dans quelle table de la BDTOPO peut-on trouver les ponts?
Explorer la structure des tables
gpf_wfs_describe_type(typename) pour récupérer le schéma d'une table (DescribeFeatureType)
Quelles sont les informations disponibles pour les communes avec ADMINEXPRESS-COG.LATEST?
Compare le modèle des communes entre ADMINEXPRESS-COG:2024 et ADMINEXPRESS-COG.LATEST
Explorer les données des tables
gpf_wfs_get_features(typename,...) pour récupérer les données d'une table (GetFeature)
Quelles sont les 5 communes les plus peuplées du Doubs (25)?
Combien y-a-t'il de bâtiments à moins de 5 km de la tour Eiffel?
Contribution
Problèmes et demandes d'évolutions
N'hésitez pas à créer une issue si vous rencontrez un problème! Merci de fournir :
L'assistant et le modèle utilisé
La demande que vous faite à l'assistant (ex : "Combien y a-t'il de pont franchissant la seine?")
Proposer une nouvelle fonctionnalité
N'hésitez pas :
Forker le dépôt
Créer un nouveau tool
Tester de votre côté
Faire une pull-request
Crédits
mcp-framework fournit le cadre de développement du MCP :
@camptocamp/ogc-client pour la lecture des réponses XML des services WFS, WMTS,...
MiniSearch pour la recherche par mot clé.
jsts pour les traitements géométriques (ex : tri des réponses par distance au point recherché).
Licence
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides spatial context and geographic data access for LLMs through France's Géoplateforme services, including geocoding, altitude queries, administrative boundaries, cadastral data, and vector data exploration.