geocodage-mcp

Serveur MCP (Model Context Protocol) connecté à l'API de géocodage de la Géoplateforme (IGN).
Permet de géocoder des adresses, lieux (POI) et parcelles cadastrales françaises en temps réel, ainsi que de faire du géocodage inverse.

API publique, sans clé. Limite : 50 requêtes/seconde par IP.
Sources : BAN (adresses), BD TOPO® (POI), Parcellaire Express PCI (parcelles).

Prérequis

• Node.js >= 18

Related MCP server: Geocode BAN MCP

Installation

npm install

Démarrage

node index.js

Le serveur communique via stdio et est prêt à être connecté à un client MCP.

Outils exposés

geocode

Géocodage direct via GET https://data.geopf.fr/geocodage/search.

Paramètres principaux :

Exemples de requêtes :

• q=10 rue de la Paix Paris

• q=cimetière Vincennes, index=poi

• q=75056104AE0003, index=parcel

geocode_reverse

Géocodage inverse via GET https://data.geopf.fr/geocodage/reverse.

Paramètres principaux :

* Requis si searchgeom absent.

Exemple Circle :

{ "type": "Circle", "coordinates": [2.294469, 48.858244], "radius": 100 }

geocode_capabilities

Retourne les capacités de l'API via GET https://data.geopf.fr/geocodage/getCapabilities : opérations disponibles, index, champs interrogeables, valeurs de catégories POI, etc.

Aucun paramètre requis.

Structure du projet

geocodage-mcp/
├── index.js              # Entrée MCP : déclaration des outils + connexion stdio
├── package.json
└── src/
    ├── client.js         # Client HTTP fetch vers l'API Géoplateforme
    └── tools/
        ├── search.js     # Schéma Zod + handler geocode
        ├── reverse.js    # Schéma Zod + handler geocode_reverse
        └── capabilities.js  # Handler geocode_capabilities

Intégration

{
  "servers": {
    "geocodage": {
      "type": "stdio",
      "command": "node",
      "args": ["/chemin/vers/geocodage-mcp/index.js"]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "geocodage": {
      "command": "node",
      "args": ["/chemin/vers/geocodage-mcp/index.js"]
    }
  }
}

Exemple de recherche

Configuration :

Requête initiale :

10 rue du chateau avec @mcp:geocodage: ?

Used MCP tool: geocodage/geocode

En cherchant "10 rue du chateau" sans préciser de ville avec l'outil MCP geocodage, l'API retourne plusieurs correspondances possibles, car c'est une adresse très courante en France.

Voici les 5 correspondances les plus pertinentes :

1. 10 Rue du Château, 92600 Asnières-sur-Seine

   • Longitude : 2.28736

   • Latitude : 48.906493

2. 10 rue du Château, 29200 Brest

   • Longitude : -4.490812

   • Latitude : 48.383654

3. 10 Rue du Château, 44000 Nantes

   • Longitude : -1.552009

   • Latitude : 47.216291

4. 10 Rue du Chateau, 21000 Dijon

   • Longitude : 5.037218

   • Latitude : 47.323033

5. 10 Rue du Château, 92500 Rueil-Malmaison

   • Longitude : 2.180793

   • Latitude : 48.875649

Souhaitez-vous préciser une ville ou un code postal pour affiner ce résultat, ou cherchez-vous les coordonnées d'une de ces villes en particulier ?

et à Seurre ?

Pour le 10 Rue du Château à Seurre (21250), l'outil MCP geocodage trouve bien cette adresse unique. Voici les coordonnées précises :

• Longitude : 5.145836

• Latitude : 46.997484

Si vous souhaitez visualiser cette position exacte sur une carte (avec un fort niveau de zoom), voici les liens d'accès direct correspondants :

• Google Maps : https://www.google.com/maps/@46.997484,5.145836,20z

• OpenStreetMap : https://www.openstreetmap.org/?mlat=46.997484&mlon=5.145836#map=19/46.997484/5.145836

• Géoportail : https://www.geoportail.gouv.fr/carte?c=5.145836,46.997484&z=19