Geocontext

🚀 地理上下文服務

這是一個實驗性的MCP服務器，旨在為大語言模型（LLM）提供空間上下文信息，助力其在地理數據處理方面更準確地響應。

🚀 快速開始

已發佈版本的使用

例如，通過 “Cursor Settings / MCP / Add server” 進行如下配置：

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

使用Docker

docker compose build
docker compose up -d

之後，進行如下配置：

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

✨ 主要特性

使用空間服務

• 地理編碼：geocode(text) 藉助 地理平臺自動完成服務，將地名轉換為經緯度位置。

  示例：“巴黎市政廳的經緯度位置是多少？”

• 海拔查詢：altitude(lon,lat) 利用 地理平臺海拔計算服務，將經緯度位置轉換為海拔高度。

  示例：“洛雷（25）市政廳的海拔是多少？”

地點信息查詢

• 行政信息：adminexpress(lon,lat) 可獲取指定地點的行政信息，如城市、部門、地區等。

  示例：“巴黎市政廳的行政信息有哪些？”

• 地籍信息：cadastre(lon,lat) 用於獲取指定地點的地籍信息，如地塊、圖紙等。

  示例：“巴黎市政廳的地籍信息有哪些？”

• 城市規劃信息：urbanisme(lon,lat) 可獲取指定地點的城市規劃信息，如PLU、POS、CC、PSMV。

  示例：“馬賽港現行的PLU文件是什麼？”

• 公共服務地役權信息：assiette_sup(lon,lat) 用於獲取指定地點的公共服務地役權（SUP）信息。

矢量數據探索

探索表格

• gpf_wfs_list_types()：列出地理平臺WFS上的可用表格（GetCapabilities），此功能已棄用（結果過多）。
• gpf_wfs_search_types(keywords,max_results=10)：搜索地理平臺WFS上的可用表格（GetCapabilities）。

  示例：

  • 地理平臺上可用的ADMINEXPRESS版本有哪些？
  • BDTOPO中對應建築物的表格是哪個？
  • 在BDTOPO的哪個表格中可以找到橋樑？

探索表格結構

• gpf_wfs_describe_type(typename)：獲取表格的架構（DescribeFeatureType）。

  示例：

  • ADMINEXPRESS-COG.LATEST中關於城市的可用信息有哪些？
  • 比較ADMINEXPRESS-COG:2024和ADMINEXPRESS-COG.LATEST中城市模型的差異。

探索表格數據

• gpf_wfs_get_features(typename,...)：獲取表格的數據（GetFeature）。

  示例：

  • 杜省（25）人口最多的5個城市是哪些？
  • 距離埃菲爾鐵塔不到5公里的建築物有多少？

📦 安裝指南

構建本地版本

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

使用本地版本

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

調試本地版本

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

📚 詳細文檔

動機

大語言模型讓人們覺得計算機似乎無所不能，但實際上並非如此。例如，要讓助手知道日期和時間，就需要將其與 MCP time 進行對接；要讓助手讀取網頁，就需要將其與 MCP fetch 進行對接。

在地理數據方面，如果用戶提出需要助手知道地址位置的問題，答案很可能看似合理但實際上是錯誤的。雖然從技術上可以連接像APICARTO這樣的REST/GeoJSON API，但這些API的設計並不適合（默認返回5000個結果、響應中包含大的幾何圖形、需要提供複雜的幾何圖形等）。

因此，本項目的目標是嘗試設計一個MCP，使地理平臺的數據和服務能夠被大語言模型訪問。

注意事項

• 此開發項目是與IgnFab合作的概念驗證項目（mborne/geocontext 正在歸檔中）。
• 如果證明該項目有工業化的價值，倉庫將轉移到IGN的管理下，並且工具將被重新命名（例如：IGNF/mcp-gpf-server）。
• 已經識別出了一些可能的問題和改進點，目前正在進行緩解和解決（詳見 issues）。
• 該工具並非萬能（可參考 功能特性 瞭解其能力範圍）。

設計原則

• 不復制地理平臺的數據：目的是識別服務可能的改進之處，而不是重複數據。
• 儘量減少響應的大小：目的是優化令牌數量、避免幻覺現象、能夠使用本地模型。

參數配置

對於高級使用場景，可參考以下參數配置：

🔧 技術細節

本項目依賴以下技術和工具：

• mcp-framework：提供MCP的開發框架。

  # 例如，用於展示WMTS圖層列表
  mcp add tool gpf_wmts_layers
  

• @camptocamp/ogc-client：用於讀取WFS、WMTS等服務的XML響應。
• MiniSearch：用於關鍵字搜索。
• jsts：用於幾何處理（例如，按與搜索點的距離對響應進行排序）。

🤝 貢獻指南

問題反饋與功能需求

如果您遇到問題，請隨時 創建一個issue。請提供以下信息：

• 使用的助手和模型。
• 向助手提出的問題（例如：“跨越塞納河的橋樑有多少座？”）。

提出新功能建議

歡迎您為項目貢獻新功能：

1. 分叉倉庫。
2. 創建新的工具。
3. 進行本地測試。
4. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證。