Openstreetmap MCP Server

🚀 OpenStreetMap (OSM) MCP 服務器

本項目是一個增強大語言模型（LLM）功能的 OpenStreetMap MCP 實現，將地理位置服務與空間數據相結合，助力 LLM 實現強大的地理位置應用功能。

🚀 快速開始

本服務器為 LLM 提供了與 OpenStreetMap 數據交互的工具，使其能夠實現地理位置應用程序的以下功能：

• 將地址和地名轉換為座標
• 反向地理編碼座標到地址
• 找到附近的興趣點
• 獲取地點之間的路線方向
• 在給定範圍內搜索地點
• 分類顯示附近的位置

✨ 主要特性

此服務器為 LLM 提供了與 OpenStreetMap 數據交互的工具，使其能夠實現地理位置應用程序的以下功能：

• 將地址和地名轉換為座標
• 反向地理編碼座標到地址
• 找到附近的興趣點
• 獲取地點之間的路線方向
• 在給定範圍內搜索地點
• 分類顯示附近的位置

🎥 演示

會合點優化

鄰里分析

停車搜索

📦 安裝指南

在開發環境中運行服務器時，請將以下內容添加到項目根目錄中的 pyproject.toml 文件：

[build-system]
requires = ["uvu"]

💻 使用示例

基礎用法

import asyncio
from mcp.client import Client

async def main():
    client = Client("http://localhost:8000")
    
    # 地理位置編碼
    results = await client.invoke_tool("geocode_address", {"address": "帝國大廈"})
    print(f"找到的位置：{results[0]['display_name']}")
    
    # 獲取座標
    lat = float(results[0]['lat'])
    lon = float(results[0]['lon'])
    
    # 搜索附近的咖啡店
    nearby = await client.invoke_tool(
        "find_nearby_places",
        {
            "latitude": lat,
            "longitude": lon,
            "radius": 500,
            "categories": ["cafe"],
            "limit": 5
        }
    )
    
    # 顯示結果
    print(f"找到 {nearby['total_count']} 個附近地點")
    for category, subcategories in nearby["categories"].items():
        for subcategory, places in subcategories.items():
            print(f"  - {subcategory}: {len(places)} 個地點")

if __name__ == "__main__":
    asyncio.run(main())

📚 詳細文檔

組件

資源

地理位置 (/location)

• 地理位置編碼：將自然語言描述轉換為經緯度座標。
  • 請求：POST /location
  • 參數：
    • query：自然語言查詢，例如 "Empire State Building"
    • bounds：搜索範圍的邊界框
  • 響應：

    {
      "results": [
        {
          "display_name": "地點名稱",
          "lat": "緯度",
          "lon": "經度",
          "confidence": "置信度"
        }
      ]
    }
    

搜索 (/search)

• 附近搜索：在指定位置和半徑內查找地點。
  • 請求：GET /search
  • 參數：
    • latitude：中心點緯度
    • longitude：中心點經度
    • radius：搜索半徑（米）
    • categories：指定分類，例如 ["restaurant", "hotel"]
  • 響應：

    {
      "results": [
        {
          "display_name": "地點名稱",
          "lat": "緯度",
          "lon": "經度",
          "category": "類別"
        }
      ],
      "total_count": "結果總數"
    }
    

使用案例

1. 房地產決策

• 用例：在某個城市中心查找適合購房的區域。
• 步驟：
  1. 使用地理位置編碼獲取目標區域的經緯度。
  2. 在該區域內搜索教育資源、醫療設施和商業中心。
  3. 分析結果以評估該區域的生活質量。

2. EV 充電站尋找

• 用例：找到距離最近的電動汽車充電站。
• 步驟：
  1. 獲取當前所在位置的經緯度。
  2. 在半徑為 500 米範圍內搜索分類為"electric_charge"的地點。
  3. 顯示結果並排序。

🔧 調試說明

由於 MCP 服務器通過標準輸入輸出運行，調試可能較為困難。我們強烈推薦使用 MCP 檢查器 來進行調試。

你可以通過以下命令啟動 MCP 檢查器：

npx @modelcontextprotocol/inspector uv --directory /path/to/osm-mcp-server run osm-mcp-server

啟動後，檢查器會顯示一個 URL，可以在瀏覽器中訪問以開始調試。