Ign Apicarto MCP Server

🚀 IGN API Carto MCP 服務器

本服務器允許您直接從 Claude Desktop 或任何其他兼容 MCP 的客戶端訪問法國國家地理與森林信息研究所（IGN）的豐富地理數據。它公開了 IGN API Carto 生態系統的主要 API，支持以自然語言查詢法國的地籍、農業、環境、城市規劃和行政數據。

🚀 快速開始

本 MCP 服務器允許直接從 Claude Desktop 或任何其他兼容 MCP 的客戶端訪問法國國家地理與森林信息研究所（IGN）的豐富地理數據。要使用該服務器，您需要完成以下步驟：

1. 安裝必要的依賴項（Node.js 16+ 和 npm）。
2. 克隆項目倉庫並安裝依賴。
3. 配置環境變量，添加 IGN API 密鑰（如果需要）。
4. 編譯項目。
5. 根據您使用的客戶端（Claude Desktop、Claude Code、Cursor 等）進行相應的配置。

配置完成後，您就可以在 Claude Desktop 中以自然語言查詢 IGN 數據，服務器會自動將您的請求轉換為適當的 API 調用。

✨ 主要特性

可用工具

📦 安裝指南

1. 克隆倉庫

git clone https://github.com/votre-utilisateur/ign-apicarto-mcp-server.git
cd ign-apicarto-mcp-server

2. 安裝依賴

npm install

3. 配置環境變量

# 複製示例文件
cp .env.example .env.local

編輯 .env.local 文件，並添加您的 IGN API 密鑰（如果您想使用葡萄酒產區端點）：

# 獲取免費密鑰：https://geoservices.ign.fr/
IGN_API_KEY=votre_cle_api

4. 編譯項目

npm run build

編譯後的服務器文件將位於 dist/ 目錄中。

🔧 配置

根據您使用的客戶端，按以下說明配置 MCP 服務器：

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

{
  "enableAllProjectMcpServers": true
}

{
  "enabledMcpjsonServers": ["ign-apicarto"]
}

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["${workspaceFolder}/ign-apicarto-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "ign-apicarto": {
      "command": "node",
      "args": ["/chemin/absolu/vers/ign-apicarto-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "ign-apicarto": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

TRANSPORT=http PORT=3000 npm start

傳輸模式

服務器支持兩種通信模式：

stdio 模式（默認）

用於與 Claude Desktop 進行本地使用的標準模式：

npm start

HTTP 模式（可選）

用於網絡使用或從遠程客戶端訪問：

TRANSPORT=http PORT=3000 npm start

環境變量

通過 .env.local 文件或直接在命令行中配置服務器：

配置文件：

• .env.example：包含所有可用變量的模板。
• .env.local：您的本地配置（不進行版本控制）。

💻 使用示例

基礎用法

配置完成後，您可以在 Claude Desktop 中以自然語言查詢 IGN 數據，以下是一些示例：

Quelles communes sont associées au code postal 75001 ?

服務器會自動將此請求轉換為對 ign_get_communes_by_postal_code 工具的 API 調用，並返回相關城市的信息。

高級用法

如果您需要進行更復雜的查詢，例如結合多個工具或使用特定的參數，可以參考以下示例：

Trouve les parcelles cadastrales de la commune avec le code INSEE 75101 dans la section cadastrale 'A'

這將調用 ign_get_cadastre_parcelles 工具，並指定 INSEE 代碼和地籍分區，以獲取特定的地籍地塊信息。

📚 詳細文檔

使用案例

• 🏘️ 分析地籍和地塊數據
• 🌾 查閱農業聲明（RPG）
• 🌳 識別自然保護區
• 🏗️ 驗證城市規劃法規（PLU、GPU）
• 🍷 定位葡萄酒產區
• 🗺️ 獲取地理定位的行政數據

已完成項目

🍷 瑪歌 - 坎特南克地區分析

這是一個交互式的領土分析應用程序，用於瑪歌 - 坎特南克（吉倫特省）的葡萄酒產區。該應用程序使用 Claude 和本 MCP 服務器開發，提供了對該地區的全面分析，包括以下模塊：

技術棧

• 使用標籤頁導航的 React 界面
• 集成 IGN 和 INPN（法國國家自然歷史博物館）的數據
• 地理可視化（邊界框、精確座標）
• 使用顏色代碼區分不同類型的領土區域

如何重現？

創建一個交互式的 React 應用程序，用於分析瑪歌 - 坎特南克地區的領土。使用 IGN 數據顯示：
- 行政信息
- 完整的 PLU 分區
- 自然保護區
- 地籍分區

界面應通過標籤頁進行組織，實現流暢的導航。

詳細示例

1. 按郵政編碼搜索

問題：

Quelles communes sont associées au code postal 75001 ?

預期響應：

• 包含 INSEE 代碼的城市列表
• 地理座標
• 行政邊界

使用工具： ign_get_communes_by_postal_code

2. 搜索地籍地塊

問題：

Trouve les parcelles cadastrales de la commune avec le code INSEE 75101

可能的參數：

• 城市的 INSEE 代碼
• 地籍分區
• 地塊編號

使用工具： ign_get_cadastre_parcelles

3. 驗證城市規劃分區

問題：

Quel est le zonage PLU à ces coordonnées : {"type":"Point","coordinates":[2.35,48.85]} ?

返回信息：

• 區域類型（U、AU、A、N）
• 適用的城市規劃法規
• 可建設性限制
• PLU 更新日期

使用工具： ign_get_gpu_urbanisme

4. 自然保護區

問題：

Y a-t-il des zones Natura 2000 à proximité de ce point : {"type":"Point","coordinates":[-1.69,48.10]} ?

返回的區域類型：

• Natura 2000 站點（ZSC、ZPS）
• ZNIEFF（I 型和 II 型）
• 國家和地區公園
• 自然保護區

使用工具： ign_get_nature_areas

5. 地塊圖形登記冊（農業）

問題：

Quelles cultures sont déclarées sur cette parcelle agricole en 2023 ?
Géométrie : {"type":"Point","coordinates":[2.35,45.85]}

可用數據：

• 作物類型
• 申報面積
• PAC 作物代碼
• 申報年份（2010 - 2024）

使用工具： ign_get_rpg

6. 葡萄酒產區

⚠️ 重要提示

此端點需要免費的 IGN API 密鑰。您可以在 geoservices.ign.fr 獲取。

問題：

Cette parcelle est-elle située dans une AOC viticole ?
Coordonnées : {"type":"Point","coordinates":[4.84,45.76]}

返回信息：

• 產區類型（AOC、IGP、VSIG）
• 產區名稱
• 產區標識符
• 區域幾何形狀

使用工具： ign_get_aoc_viticoles

所需配置：

# 在 .env.local 中
IGN_API_KEY=votre_cle_api

7. 行政邊界

問題：

Dans quel département et quelle région se trouve la commune de Lyon ?

可用數據：

• 城市邊界
• 部門輪廓
• 地區輪廓
• 官方地理代碼

使用工具： ign_get_administrative_limits

幾何格式

幾何圖形必須採用 GeoJSON 格式，並使用 WGS84（EPSG:4326）投影：

// 點
{"type":"Point","coordinates":[經度, 緯度]}

// 多邊形
{"type":"Polygon","coordinates":[[[lon1,lat1],[lon2,lat2],[lon3,lat3],[lon1,lat1]]]}

// 多多邊形
{"type":"MultiPolygon","coordinates":[[[[lon1,lat1],[lon2,lat2],...]],[...]]}

🔧 技術細節

項目結構

ign-apicarto-mcp-server/
├── src/
│   ├── index.ts          # MCP 服務器的入口點
│   ├── api-client.ts     # IGN API 的 HTTP 客戶端
│   └── types.ts          # TypeScript 類型
├── dist/                 # 編譯後的文件
├── .env.example          # 環境變量模板
├── .env.local            # 本地配置（不進行版本控制）
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

可用腳本

# 以開發模式啟動服務器
npm run dev

# 編譯項目
npm run build

# 以生產模式啟動服務器
npm start

# 運行測試（如果可用）
npm test

# 檢查代碼
npm run lint

貢獻

歡迎貢獻代碼！要進行貢獻，請按照以下步驟操作：

1. Fork 項目。
2. 創建一個新的功能分支 (git checkout -b feature/AmazingFeature)。
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')。
4. 將更改推送到分支 (git push origin feature/AmazingFeature)。
5. 打開一個 Pull Request。

添加新工具

要添加新的 MCP 工具，請按照以下步驟操作：

1. 在 src/tools/ 中創建一個新文件。
2. 定義工具的參數和模式。
3. 實現對 IGN API 的調用邏輯。
4. 在 src/index.ts 中註冊該工具。
5. 在本 README 中記錄該工具。

📄 許可證

本項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。

IGN 數據

IGN 數據受 開放許可證 v2.0 約束。

為法國地理空間社區用心開發 ❤️