open-streetmap-mcp

用途

OpenStreetMap (OSM) MCP Server 是一个基于 OpenStreetMap 的 MCP（模型上下文协议）服务器实现，旨在为大语言模型（LLM）提供位置服务和地理空间数据交互能力，使 LLM 能够处理基于位置的应用程序。

主要能力

该服务器为 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：定位目的地附近的停车选项

使用方式

该服务器可在 Claude Desktop、Cursor、Windsurf 等 MCP 主机中使用。

主服务器 osm-mcp-server 可供公共使用，配置示例如下：

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

在 Claude Desktop 中，配置文件位于：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

本地运行服务器：

• 以开发模式安装包
• 启动服务器

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

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

• client.py 演示 OSM MCP 服务器的基础用法：连接本地运行的服务器、获取旧金山信息、搜索该区域餐厅、检索带进度跟踪的全面地图数据。
• llm_client.py 提供一个为 LLM 集成设计的辅助类，展示 LLM 如何使用位置助手：从文本查询获取位置信息、获取地点之间的路线、找到最优会议点、探索社区。

编写自己的客户端：

• 导入 MCP 客户端
• 使用服务器 URL 初始化客户端
• 调用工具或访问资源

构建与发布

准备分发包：

• 同步依赖并更新锁文件
• 构建包分发
• 在 dist/ 目录中生成源码和 wheel 分发
• 发布到 PyPI（需要通过环境变量或命令行标志设置 PyPI 凭据）

调试

由于 MCP 服务器通过 stdio 运行，调试可能具有挑战性。建议使用 MCP Inspector 获得最佳调试体验。可通过 npm 命令启动 MCP Inspector，启动后将显示一个可在浏览器中访问的 URL，用于开始调试。

限制

资料中未提供关于定价、平台兼容性、性能或使用限制的其他信息。