Osm MCP

OpenStreetMap MCP服务器

一个强大的 模型上下文协议（MCP） OpenStreetMap服务器，提供 30工具 用于地理编码、路由、质量保证和数据分析。针对Cursor和Claude等AI助手进行了优化。

Grab的社区项目 --提供开源地图工具，帮助开发人员和研究人员更有效地使用OpenStreetMap数据。

______________________________________________________________________

🎯 快速开始

1.️⃣ 安装

git clone https://github.com/GRABOSM/osm-mcp.git
cd osm-mcp
npm install
npm run build

2.️⃣ 配置AI集成

光标AI

1. 打开的游标 设置 → 特性 → 模型上下文协议.
2. 使用以下命令添加新服务器：

- 类型: command - 命令: node /absolute/path/to/osm-mcp/dist/index.js

光标桌面

将此添加到您的 mcp.json:

{
  "mcpServers": {
    "osm-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/osm-mcp/dist/index.js"]
    }
  }
}

克劳德桌面

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "osm": {
      "command": "node",
      "args": ["/absolute/path/to/osm-mcp/dist/index.js"]
    }
  }
}

3.️⃣ 开始使用

试着问你的AI：

• “在马尼拉马卡蒂找到咖啡店”
• “从Grab新加坡总部计算15分钟的行车等时线”
• “获取从樟宜机场到滨海湾金沙的路线”

______________________________________________________________________

🚀 主要特点

• 地理编码：在全球范围内搜索地址和地标。
• 路由（OSRM）：转弯方向、距离矩阵和路线优化。
• 智能POI：使用智能标签检测查找餐馆、商店和景点。
• 质量保证（OSMOSE）：检测映射错误并监控数据质量。
• 变更集分析：分析最近的编辑和用户贡献。
• 标签智能（Taginfo）：真实世界的标签使用统计和验证。
• 双接口：通过MCP（AI工具）或HTTP REST API使用。

______________________________________________________________________

🛠️ 工具参考（30个工具）

🗺️ 地理编码（4）

1. search_location：搜索地点和地址。
2. reverse_geocode：从坐标中获取地址。
3. search_structured：按街道、城市、国家等搜索。
4. get_place_details：获取OSM元素的完整细节。

📍 兴趣点（3）

1. search_pois：一般POI搜索（设施、商店等）。
2. search_pois_smart：具有类别检测功能的智能POI搜索。
3. find_amenities_nearby：在特定半径内定位设施。

🛣️ 路线与导航（5）

1. get_osrm_route：详细的转弯指示。
2. get_distance_matrix：多个点之间的行程时间和距离。
3. optimize_route：通过多站（TSP）找到最佳路线。
4. map_match_gps：将GPS轨迹捕捉到道路网络。
5. calculate_isochrone：在规定时间内可到达的区域。

📊 OSM数据分析（6）

1. search_highways_smart：智能搜索道路和高速公路。
2. get_elements_in_bounds：获取边界框内的所有数据。
3. search_by_tags：通过特定的OSM标签查找元素。
4. get_route_data：提取道路几何图形以供自定义使用。
5. execute_overpass_query：运行高级Overpass QL查询。
6. snap_to_roads：找到任何一点最近的路。

🔄 变更集分析（3）

1. get_changeset：特定映射编辑的详细信息。
2. search_changesets：按用户、时间或位置查找编辑。
3. get_changeset_diff：查看编辑中所做的确切更改。

🔍 质量保证（6）

1. osmose_search_issues：使用筛选器查找数据错误。
2. osmose_get_issue_details：特定质量问题的详细信息。
3. osmose_get_issues_by_country：按国家划分的质量问题。
4. osmose_get_issues_by_user：与特定用户有关的问题。
5. osmose_get_stats：数据质量指标和图表。
6. osmose_get_items：可检测问题类别清单。

🏷️ 标签智能（3）

1. get_tag_suggestions：OSM标签的自动补全功能。
2. get_tag_stats：任何标签的使用统计。
3. validate_osm_tag：检查标签组合是否正确。

______________________________________________________________________

💡 示例用法

导航

“获取从吉隆坡中央车站到双子塔的路线”

城市规划

“从Grab新加坡总部计算30分钟行车等时线”

质量监控

“分析班加罗尔最近的测绘活动”

______________________________________________________________________

🌐 HTTP API模式

作为独立服务器运行：

npm run dev:http

访问文档： http://localhost:8888/api/info

______________________________________________________________________

🛠️ 故障排除

• 绝对路径：在AI工具配置中始终使用完整路径。
• 先建造：确保你跑步 npm run build 在任何改变之后。
• 节点版本：使用Node.js v18或更高版本。

______________________________________________________________________

📄 许可证

该项目根据 MIT许可证.

______________________________________________________________________

🙏 学分

• OpenStreetMap贡献者
• OSRM, 提名, 天桥, 渗透酶, 标签信息 社区。