MCP Geo

🚀 MCP-Geo

MCP-Geo 是一個利用 GeoPY 實現的地理編碼服務器，為大型語言模型提供強大的地理編碼工具！

🚀 快速開始

1. 安裝所需依賴項：

   pip install -r requirements.txt
   

2. 配置環境變量（可選）： 根據需要設置以下環境變量：

   export GEOCODER_PROVIDER="nominatim"  # 可選：nominatim、arcgis 或 bing
   export NOMINATIM_URL="nominatim.openstreetmap.org"  # 可選：Nominatim 域
   export SCHEME="http"  # 可選：http 或 https
   export ARC_USERNAME="your_arcgis_username"  # 可選：ArcGIS 用戶名
   export ARC_PASSWORD="your_arcgis_password"  # 可選：ArcGIS 密碼
   export BING_API_KEY="your_bing_maps_key"  # 必需（僅限 Bing）
   

3. 運行服務器：

   python server.py
   

✨ 主要特性

此 MCP 服務器為大型語言模型 (LLMs) 提供以下地理編碼工具：

• geocode_location：接受用戶提供的地址或地名，並返回最佳匹配的緯度、經度和格式化地址。若找不到位置或發生錯誤，會處理錯誤並優雅返回 None。
• reverse_geocode：接受緯度和經度，並返回最近的地址，用於查找地圖上某點的描述性信息。
• geocode_with_details：類似於 geocode_location，但返回更多數據，如邊界框和其他詳細地址信息（如果地理編碼器支持）。
• geocode_multiple_locations：接受地址字符串列表，併為每個地址返回緯度和經度，支持多個位置的批量處理。
• reverse_geocode_multiple_locations：接受緯度和經度列表，併為每個座標返回最近的地址，適合批量反向地理編碼操作。

📦 安裝指南

系統要求

• Python 3.6+

依賴項

安裝所有必需的依賴項：

# 使用 uv
uv 同步

必需包

• fastmcp：構建模型上下文協議服務器的框架。
• geoPy：用於訪問和對地址或位置進行地理編碼/反向地理編碼的 Python 庫。

所有依賴項均在 requirements.txt 中列出，以便輕鬆安裝。

📚 詳細文檔

安全功能

• 所有地理編碼請求均通過 HTTPS 默認進行，確保數據傳輸安全。
• 支持限制速率和 API 密鑰驗證（針對 Bing 地理編碼器）。

開發文檔

要了解如何擴展或自定義服務器，請參閱 geo.py 和 server.py 文件。您可以根據需要添加更多地理編碼功能或調整現有邏輯。

環境變量

這些變量可以在您的 shell 中設置，或在 MCP 設置文件中根據環境進行配置。如果需要更多自定義，請編輯 geo.py 文件，並添加所需的地理編碼器參數。