MCP Datagouv Ign

🚀 MCP Server - French Open Data + IGN

A complete MCP server that enables Claude to access French public data and national mapping services.

🚀 Quick Start

This MCP server provides access to a wealth of French public data and mapping services. After proper installation and configuration, you can use it with Claude to query various data and services.

✨ Features

📦 Data Sources

1. data.gouv.fr - Open platform for public data

• Search for datasets
• Get information about organizations
• Find data re - uses

2. IGN Geoplateforme - Mapping, navigation, and altimetry services

• WMTS: Pre - generated map tiles (fast)
• WMS: On - demand maps (customizable)
• WFS: Vector data (for analysis)
• Route: Calculate optimized routes
• Isochrone: Temporal/distance accessibility zones
• Altimetry: Calculate altitude and altimetric profiles

3. API Adresse - National geocoding

• Convert addresses to GPS coordinates
• Convert coordinates to addresses
• Address autocompletion

4. API Geo - Administrative division

• Over 35,000 French communes
• Departments and regions
• Demographic data

🛠️ Available Tools (38 in total)

Data.gouv.fr (6 tools)

• search_datasets - Search for datasets
• get_dataset - Get details of a dataset
• search_organizations - Search for organizations
• get_organization - Get details of an organization
• search_reuses - Search for data re - uses
• get_dataset_resources - List files of a dataset

IGN Geoplateforme - Mapping (9 tools)

• list_wmts_layers - List WMTS layers
• search_wmts_layers - Search for WMTS layers
• get_wmts_tile_url - Get WMTS tile URL
• list_wms_layers - List WMS layers
• search_wms_layers - Search for WMS layers
• get_wms_map_url - Get WMS map URL
• list_wfs_features - List WFS features
• search_wfs_features - Search for WFS features
• get_wfs_features - Retrieve vector data

IGN Geoplateforme - Navigation (3 tools)

• get_route_capabilities - Retrieve route capabilities (resources, profiles)
• calculate_route - Calculate a route between two points
• calculate_isochrone - Calculate an isochrone/isodistance

IGN Geoplateforme - Altimetry (3 tools)

• get_altimetry_resources - List altimetric resources (DEM, DSM)
• get_elevation - Get the altitude of one or more points
• get_elevation_line - Calculate an altimetric profile (elevation differences)

API Adresse (3 tools)

• geocode_address - Address → GPS
• reverse_geocode - GPS → Address
• search_addresses - Address autocompletion

API Geo (6 tools)

• search_communes - Search for communes
• get_commune_info - Get complete commune information
• get_departement_communes - Get communes of a department
• search_departements - Search for departments
• search_regions - Search for regions
• get_region_info - Get region information

Spatial Processing (8 tools)

• reproject_geodata - Reproject a dataset to a target CRS
• buffer_geodata - Calculate a metric buffer while controlling cap/join style
• intersect_geodata - Intersection between two vector layers
• clip_geodata - Clip a layer by a clipping geometry
• convert_geodata_format - Convert GeoJSON ↔ KML ↔ GeoPackage ↔ Shapefile (base64)
• get_geodata_bbox - Return the bounding box (minx/miny/maxx/maxy)
• dissolve_geodata - Group geometries (dissolve) with attribute aggregations
• explode_geodata - Disassemble multi - part geometries

📦 Installation

1. Install dependencies

pip install -r requirements.txt

⚠️ Important Note

The GeoPandas dependencies involve GDAL, PROJ, and GEOS.
macOS: Run brew install gdal before Python installation.
Linux: Install the gdal - bin libgdal - dev proj - bin packages.
Windows: Use a Python distribution that includes GeoPandas wheels (conda/mini - forge recommended) or install GDAL from https://www.gisinternals.com/.

2. Configure Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "french - opendata": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/french_opendata_complete_mcp.py"
      ]
    }
  }
}

⚠️ Important Note

Replace /ABSOLUTE/PATH/TO/ with the actual path where you placed the files.

3. Restart Claude Desktop

Completely close Claude Desktop and restart it.

💻 Usage Examples

Geocoding + Mapping

"Geocode the address '1 Avenue des Champs - Élysées, Paris' and then display it on an IGN map"

Territorial Search

"What is the population of Lyon? Show me the orthophotos and find open data"

Geographic Analysis

"Retrieve the administrative boundaries of Brittany in GeoJSON"

Route Calculation

"Calculate the fastest driving route between Paris and Lyon"

Isochrone

"Show me the areas accessible within 30 minutes by car from the center of Marseille"

Altimetry

"What is the altitude of Mont Blanc?"

"Calculate the altimetric profile between Grenoble and l'Alpe d'Huez with elevation differences"

📁 File Structure

mcp - datagouv - ign/
├── french_opendata_complete_mcp.py    # Main server
├── ign_geo_services.py                # IGN module (mapping + navigation + altimetry)
├── test_navigation.py                 # Navigation tests
├── test_altimetrie.py                 # Altimetry tests
├── requirements.txt                   # Dependencies
├── README.md                          # Main documentation
├── EXEMPLES_NAVIGATION.md             # Detailed navigation examples
├── EXEMPLES_ALTIMETRIE.md             # Detailed altimetry examples
└── CHANGELOG.md                       # Version history

🔧 Troubleshooting

The server does not start

1. Check Python 3.8+ : python --version
2. Check dependencies : pip list | grep -E "mcp|httpx"
3. Check absolute paths in the configuration

Tools do not appear in Claude

1. Completely restart Claude Desktop
2. Check logs: Menu → Settings → Developer

Connection errors

• Check your Internet connection
• Public APIs may have rate limits

📚 Documentation

• data.gouv.fr: https://doc.data.gouv.fr/api/
• IGN Geoplateforme: https://geoservices.ign.fr/
• IGN Navigation: https://geoservices.ign.fr/documentation/services/services - geoplateforme/itineraire
• IGN Altimetry: https://geoservices.ign.fr/documentation/services/services - geoplateforme/altimetrie
• API Adresse: https://adresse.data.gouv.fr/api - doc/adresse
• API Geo: https://geo.api.gouv.fr/

For detailed examples of using navigation tools, refer to EXEMPLES_NAVIGATION.md.

🎨 Popular IGN Layers

WMTS/WMS

• ORTHOIMAGERY.ORTHOPHOTOS - Aerial photos
• GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2 - IGN map
• CADASTRALPARCELS.PARCELLAIRE_EXPRESS - Cadastre
• TRANSPORTNETWORKS.ROADS - Road network
• ADMINISTRATIVEUNITS.BOUNDARIES - Administrative boundaries

WFS (Vector data)

• ADMINEXPRESS - COG - CARTO.LATEST:commune - Communes
• ADMINEXPRESS - COG - CARTO.LATEST:departement - Departments
• BDTOPO_V3:batiment - Buildings

📄 License

This MCP server uses French public APIs. Refer to the terms of use of each service.

🆘 Support

For any questions:

1. Refer to the API documentation
2. Check the Claude Desktop logs
3. Ensure you are using the latest version of the MCP SDK

Created to facilitate access to French open data 🇫🇷