OpenStreetMap (OSM) MCP 服务器

一个增强 LLM 能力的 OpenStreetMap MCP 服务器实现，通过基于位置的服务和地理空间数据。

演示

会面地点优化

邻里分析

停车搜索

安装

在 MCP 主机如 Claude Desktop, Cursor, Windsurf 等上

• osm-mcp-server: 主服务器，可供公共使用。

  "mcpServers": {
    "osm-mcp-server": {
      "command": "uvx",
      "args": [
        "osm-mcp-server"
      ]
    }
  }
  

功能

此服务器为 LLM 提供工具，以与 OpenStreetMap 数据交互，使基于位置的应用能够：

• 将地址和地名转换为坐标
• 将坐标反向转换为地址
• 查找附近的兴趣点
• 获取两地之间的路线方向
• 在边界框内按类别搜索地点
• 为多人建议最佳会面地点
• 探索区域并获取全面的位置信息
• 查找某位置附近的学校和教育机构
• 分析家庭和工作地点之间的通勤选项
• 查找带有连接器和功率过滤的电动汽车充电站
• 对房地产进行邻里宜居性分析
• 查找带有可用性和费用信息的停车场

组件

资源

服务器实现了基于位置的资源：

• location://place/{query}: 根据名称或地址获取地点信息
• location://map/{style}/{z}/{x}/{y}: 获取指定坐标的样式地图瓦片

工具

服务器实现了多个地理空间工具：

• geocode_address: 将文本转换为地理坐标
• reverse_geocode: 将坐标转换为可读地址
• find_nearby_places: 发现地点附近的兴趣点
• get_route_directions: 获取两地之间的逐段导航
• search_category: 在区域内查找特定类别的地点
• suggest_meeting_point: 为多人找到最佳会面地点
• explore_area: 获取关于某个邻里的全面数据
• find_schools_nearby: 查找特定位置附近的教育机构
• analyze_commute: 比较家庭和工作地点之间的交通选择
• find_ev_charging_stations: 查找带有过滤条件的电动汽车充电基础设施
• analyze_neighborhood: 对房地产进行邻里宜居性评估
• find_parking_facilities: 查找目的地附近的停车设施

本地测试

运行服务器

要本地运行服务器：

1. 以开发模式安装包：

pip install -e .

2. 启动服务器：

osm-mcp-server

3. 服务器将启动并监听标准输入/输出上的 MCP 请求。

使用示例客户端测试

仓库中包含两个示例客户端在 examples/ 目录下：

基本客户端示例

client.py 展示了 OSM MCP 服务器的基本用法：

python examples/client.py

这将：

• 连接到本地运行的服务器
• 获取关于旧金山的信息
• 在该地区搜索餐厅
• 获取带有进度跟踪的综合地图数据

LLM 集成示例

llm_client.py 提供了一个用于 LLM 集成的辅助类：

python examples/llm_client.py

这个示例展示了 LLM 如何使用位置助手：

• 从文本查询中获取位置信息
• 查找附近的兴趣点
• 获取两地之间的方向
• 查找最佳会面地点
• 探索邻里

编写自己的客户端

要创建自己的客户端：

1. 导入 MCP 客户端：

from mcp.client import Client

2. 使用您的服务器 URL 初始化客户端：

client = Client("http://localhost:8000")

3. 调用工具或访问资源：

# 示例：地理编码地址
results = await client.invoke_tool("geocode_address", {"address": "纽约市"})

Claude Desktop 配置用于本地服务器

在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

<details> <summary>开发/未发布服务器配置</summary>

"mcpServers": {
  "osm-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/osm-mcp-server",
      "run",
      "osm-mcp-server"
    ]
  }
}

</details>

开发

构建和发布

为了准备分发包：

1. 同步依赖项并更新锁文件：

uv sync

2. 构建包分布：

uv build

这将在 dist/ 目录下创建源和轮子分布。

3. 发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭证。

调试

由于 MCP 服务器通过标准 I/O 运行，调试可能具有挑战性。我们强烈推荐使用 MCP Inspector 来获得最佳调试体验。

您可以使用以下命令通过 npm 启动 MCP Inspector：

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

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 开始调试。