MCP Datagouv Ign

🚀 法國開放數據與國家地理信息研究所（IGN）MCP 服務器

這是一個完整的 MCP 服務器，可讓 Claude 訪問法國公共數據和國家地理信息服務。

🚀 快速開始

本 MCP 服務器可助力 Claude 訪問法國公共數據和國家地理信息服務。若要使用，需完成以下安裝步驟。

📦 安裝指南

1. 安裝依賴項

pip install -r requirements.txt

⚠️ 重要提示

GeoPandas 依賴項涉及 GDAL、PROJ 和 GEOS。 macOS：在安裝 Python 之前，先執行 brew install gdal。 Linux：安裝 gdal-bin libgdal-dev proj-bin 軟件包。 Windows：建議使用包含 GeoPandas 輪子的 Python 發行版（如 conda/mini - forge），或者從 https://www.gisinternals.com/ 安裝 GDAL。

2. 配置 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": [
        "/CHEMIN/ABSOLU/VERS/french_opendata_complete_mcp.py"
      ]
    }
  }
}

⚠️ 重要提示

請將 /CHEMIN/ABSOLU/VERS/ 替換為你實際存放文件的路徑。

3. 重啟 Claude Desktop

完全關閉 Claude Desktop 後重新啟動。

✨ 主要特性

📦 數據來源

1. data.gouv.fr - 公共數據開放平臺

• 搜索數據集
• 獲取組織信息
• 查看數據再利用情況

2. IGN 地理平臺 - 地圖服務、導航和高程測量

• WMTS：預生成的地圖切片（速度快）
• WMS：按需生成的地圖（可定製）
• WFS：矢量數據（用於分析）
• 路線規劃：計算優化路線
• 等時線：時間/距離可達性區域
• 高程測量：計算海拔和高程剖面

3. 地址 API - 國家地理編碼

• 地址 → GPS 座標轉換
• GPS 座標 → 地址轉換
• 地址自動補全

4. 地理 API - 行政區劃

• 35000 多個法國市鎮
• 省和地區信息
• 人口統計數據

🛠️ 可用工具（共 38 個）

Data.gouv.fr（6 個工具）

• search_datasets - 搜索數據集
• get_dataset - 獲取數據集詳情
• search_organizations - 搜索組織
• get_organization - 獲取組織詳情
• search_reuses - 搜索數據再利用情況
• get_dataset_resources - 列出數據集文件

IGN 地理平臺 - 地圖服務（9 個工具）

• list_wmts_layers - 列出 WMTS 圖層
• search_wmts_layers - 搜索 WMTS 圖層
• get_wmts_tile_url - 獲取 WMTS 切片 URL
• list_wms_layers - 列出 WMS 圖層
• search_wms_layers - 搜索 WMS 圖層
• get_wms_map_url - 獲取 WMS 地圖 URL
• list_wfs_features - 列出 WFS 要素
• search_wfs_features - 搜索 WFS 要素
• get_wfs_features - 獲取矢量數據

IGN 地理平臺 - 導航（3 個工具）

• get_route_capabilities - 獲取路線規劃能力（資源、配置文件）
• calculate_route - 計算兩點間的最佳路線
• calculate_isochrone - 計算等時線/等距線

IGN 地理平臺 - 高程測量（3 個工具）

• get_altimetry_resources - 列出高程資源（數字地形模型、數字表面模型）
• get_elevation - 獲取一個或多個點的海拔
• get_elevation_line - 計算高程剖面（高差）

地址 API（3 個工具）

• geocode_address - 地址轉 GPS 座標
• reverse_geocode - GPS 座標轉地址
• search_addresses - 地址自動補全

地理 API（6 個工具）

• search_communes - 搜索市鎮
• get_commune_info - 獲取市鎮完整信息
• get_departement_communes - 獲取省份的市鎮信息
• search_departements - 搜索省份
• search_regions - 搜索地區
• get_region_info - 獲取地區信息

空間處理（8 個工具）

• reproject_geodata - 將數據集重新投影到目標座標系
• buffer_geodata - 計算具有指定樣式的緩衝區
• intersect_geodata - 計算兩個矢量圖層的交集
• clip_geodata - 按幾何圖形裁剪圖層
• convert_geodata_format - 轉換 GeoJSON ↔ KML ↔ GeoPackage ↔ Shapefile（Base64 編碼）
• get_geodata_bbox - 返回邊界框（最小 x/最小 y/最大 x/最大 y）
• dissolve_geodata - 合併幾何圖形並進行屬性聚合
• explode_geodata - 拆分多部分幾何圖形

💻 使用示例

地理編碼 + 地圖展示

"對地址 '1 Avenue des Champs - Élysées, Paris' 進行地理編碼，然後在 IGN 地圖上顯示該地址"

區域搜索

"里昂的人口是多少？展示其正射影像並查找開放數據"

地理分析

"以 GeoJSON 格式獲取布列塔尼的行政邊界"

路線計算

"計算巴黎到里昂的最快駕車路線"

等時線分析

"展示從馬賽市中心駕車 30 分鐘可達的區域"

高程測量

"勃朗峰的海拔是多少？"

"計算格勒諾布爾到阿爾普迪埃的高程剖面和高差"

📚 詳細文檔

📁 文件結構

mcp-datagouv-ign/
├── french_opendata_complete_mcp.py    # 主服務器文件
├── ign_geo_services.py                # IGN 模塊（地圖 + 導航 + 高程測量）
├── test_navigation.py                 # 導航測試文件
├── test_altimetrie.py                 # 高程測量測試文件
├── requirements.txt                   # 依賴項文件
├── README.md                          # 主要文檔
├── EXEMPLES_NAVIGATION.md             # 詳細導航示例
├── EXEMPLES_ALTIMETRIE.md             # 詳細高程測量示例
└── CHANGELOG.md                       # 版本歷史記錄

🔧 故障排除

服務器無法啟動

1. 檢查 Python 版本是否為 3.8 及以上：python --version
2. 檢查依賴項：pip list | grep -E "mcp|httpx"
3. 檢查配置文件中的絕對路徑

工具未在 Claude 中顯示

1. 完全重啟 Claude Desktop
2. 檢查日誌：菜單 → 設置 → 開發者

連接錯誤

• 檢查你的網絡連接
• 公共 API 可能有流量限制

📚 API 文檔

• data.gouv.fr：https://doc.data.gouv.fr/api/
• IGN 地理平臺：https://geoservices.ign.fr/
• IGN 導航：https://geoservices.ign.fr/documentation/services/services - geoplateforme/itineraire
• IGN 高程測量：https://geoservices.ign.fr/documentation/services/services - geoplateforme/altimetrie
• 地址 API：https://adresse.data.gouv.fr/api - doc/adresse
• 地理 API：https://geo.api.gouv.fr/

如需詳細的導航工具使用示例，請參考 EXEMPLES_NAVIGATION.md。

🎨 熱門 IGN 圖層

WMTS/WMS

• ORTHOIMAGERY.ORTHOPHOTOS - 航空照片
• GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2 - IGN 地圖
• CADASTRALPARCELS.PARCELLAIRE_EXPRESS - 地籍圖
• TRANSPORTNETWORKS.ROADS - 公路網
• ADMINISTRATIVEUNITS.BOUNDARIES - 行政邊界

WFS（矢量數據）

• ADMINEXPRESS - COG - CARTO.LATEST:commune - 市鎮
• ADMINEXPRESS - COG - CARTO.LATEST:departement - 省份
• BDTOPO_V3:batiment - 建築物

📄 許可證

本 MCP 服務器使用法國公共 API。請查閱每個服務的使用條款。

🆘 支持

如有任何問題：

1. 查閱 API 文檔
2. 檢查 Claude Desktop 日誌
3. 確保使用的是 MCP SDK 的最新版本

本項目旨在方便訪問法國開放數據 🇫🇷