Skillget

geocontext

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Uyari
  • process.env — Environment variable access in src/gpf/wfs.ts
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This is an experimental MCP server that provides Large Language Models with geographical and spatial context. It enables AI assistants to accurately query and process location data, specifically interfacing with the French Géoplateforme API to prevent geographic hallucinations.

Security Assessment
Overall Risk: Low. The tool does not request any dangerous system permissions, and no hardcoded secrets were found. However, it does access environment variables (`process.env`) within its source code (`src/gpf/wfs.ts`), which is likely used to securely load API keys or service endpoints. Because the tool's core function is to fetch external geographic data, it inherently makes network requests to outside APIs, which is standard and expected behavior for this type of integration.

Quality Assessment
The project has an MIT license and is currently under active development, with repository pushes happening as recently as today. The documentation is thorough and transparent, explicitly outlining the project's experimental POC (Proof of Concept) status and current limitations. The main drawback is its low community visibility, having only 6 stars on GitHub. Consequently, it has not been widely tested or vetted by a large user base. Additionally, much of the documentation is written in French, which might be a consideration for global developers.

Verdict
Use with caution—while the code itself appears safe and standard, its experimental nature and lack of broad community testing mean it is better suited for development and testing environments rather than mission-critical production deployments.
SUMMARY

[DEV] An experimental MCP server providing spatial context for LLM.

README.md

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

{
  "mcpServers": {
    "geocontext": {
      "command": "npx",
      "args": ["-y", "@ignfab/geocontext"]
    }
  }
}

Utilisation avec Docker

docker compose build
docker compose up -d

Ensuite :

{
  "mcpServers": {
    "geocontext": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Développement

Construction de la version locale

git clone https://github.com/ignfab/geocontext
cd geocontext
npm install
npm run build

Utilisation de la version locale

{
  "mcpServers": {
    "geocontext": {
      "command": "node",
      "args":["/chemin/absolu/vers/geocontext/dist/index.js"]
    }
  }
}

Debug de la version locale

npx -y @modelcontextprotocol/inspector node dist/index.js

Paramétrage

Pour une utilisation avancée :

Nom Description Valeur par défaut
TRANSPORT_TYPE Transport permet de choisir entre "stdio" et "http" "stdio"
GPF_WFS_SEARCH_OPTIONS Chaîne JSON optionnelle pour ajuster la recherche gpf_wfs_search_types (fuzzy, boost.namespace, boost.name, boost.title, boost.description, boost.properties). options par défaut de @ignfab/gpf-schema-store

Exemple :

export GPF_WFS_SEARCH_OPTIONS='{"fuzzy":0.05,"boost":{"title":4,"name":5}}'

Si GPF_WFS_SEARCH_OPTIONS est absent ou vide, les options par défaut restent celles de @ignfab/gpf-schema-store.

Remarque :

  • Les outils gpf_wfs_list_types, gpf_wfs_search_types et gpf_wfs_describe_type s'appuient sur un catalogue de schémas embarqué fourni par @ignfab/gpf-schema-store.
  • L'outil gpf_wfs_get_features interroge toujours le service WFS de la Géoplateforme en direct.
  • Le catalogue embarqué améliore la description des featureTypes mais il peut être légèrement décalé par rapport à l'état courant du WFS.

Fonctionnalités

Utiliser des services spatiaux

Quelques services de la Géoplateforme :

Ex : Quelle est la position (lon,lat) de la mairie de Vincennes?

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?

Ex : Quel est le document PLU en vigueur pour le port de Marseille?

Explorer les données vecteurs

Explorer les tables

  • 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étaillé d'une table depuis le catalogue embarqué (id, namespace, name, title, description, properties)
  • 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

  • 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

# Par exemple, pour exposer la liste des couches WMTS
mcp add tool gpf_wmts_layers
  • @camptocamp/ogc-client pour la lecture des réponses XML des services WFS, WMTS,...
  • @ignfab/gpf-schema-store pour le catalogue de schémas embarqué utilisé par les outils d'exploration WFS.
  • MiniSearch pour la recherche par mot clé utilisée dans @ignfab/gpf-schema-store.
  • jsts pour les traitements géométriques (ex : tri des réponses par distance au point recherché).

Licence

MIT

Yorumlar (0)

Sonuc bulunamadi