osm-mcp

一个用于 OpenStreetMap 的 MCP 服务器：提供地理编码、步行/驾车/骑行距离与时长、多点路线优化、等时线及兴趣点搜索——专为 AI 助手的旅行规划而构建。

共 11 个工具，全部为只读。所有后端均为免费的公共 OpenStreetMap 服务；无需 API 密钥。可选择性提供 OpenRouteService 密钥以切换路由引擎。

📖 完整文档：https://osm-mcp.ni-c.de

为什么需要另一个 OSM MCP 服务器？

• 正确的步行/骑行路线。 公共 OSRM 演示服务器会忽略 OSRM URL 路径中的配置文件段，除非使用 FOSSGIS 的 routed-foot / routed-bike / routed-car 路径前缀，否则始终返回驾车路线。大多数现有的 OSM MCP 服务器在这方面都是错误的，会静默地为步行查询返回驾车时间。本服务器使用了这些前缀，其实时冒烟测试断言步行路线的速度远慢于驾车路线。

• 符合策略要求。 按服务进行速率限制（Nominatim 和 OSRM：每秒 1 个请求），每个请求都带有标识性的 User-Agent（Nominatim 使用策略要求），响应缓存，限制 Overpass 并发数（2 个槽位），并在遇到 429/5xx 错误时自动故障转移到 Overpass 镜像。

• 支持 Photon。 通过 komoot 的 Photon 提供可选的容错地理编码，该服务专为交互式使用而设计——比频繁调用 Nominatim 更适合 LLM 驱动的查询。

Related MCP server: Geo MCP Worker

系统要求

• Node.js ≥ 22

• 能够访问公共 OpenStreetMap 服务（见下表）

配置

所有变量均为可选——服务器开箱即用。

安装

claude mcp add osm -- npx -y osm-mcp

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "osm": {
      "command": "npx",
      "args": ["-y", "osm-mcp"]
    }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.osm]
command = "npx"
args = ["-y", "osm-mcp"]

容器（多架构，包含 SBOM 和构建来源）：

docker run -i --rm ghcr.io/ni-c/osm-mcp

-i 是必需的——协议通过标准输入和标准输出运行。没有需要发布的端口。更多客户端配置请参见客户端指南。

工具

每个地点输入都接受名称/地址（自动进行地理编码）或文字坐标 "lat,lon"。

使用策略与署名

本服务器与共享的社区基础设施通信。它在客户端强制执行已发布的限制，但运营方要求用户保持整体使用量较低且非商业用途：

• 数据： © OpenStreetMap 贡献者，根据 ODbL 1.0 许可。

• Nominatim： 每秒最多 1 个请求，必须使用可识别的 User-Agent，结果已缓存（策略）。

• OSRM / Valhalla (FOSSGIS)： 合理的非商业用途；每秒最多 1 个请求（关于）。

• Overpass： 每个 IP 约 2 个并发槽位，每天少于 10,000 次查询（维基）。

• Photon： 合理使用（photon.komoot.io）。

对于大量或商业用途，请自行托管服务，并将 *_BASE_URL 变量指向您的实例。

安全性

• 所有工具均为只读；服务器从不向 OpenStreetMap 写入数据。

• 无需凭据；可选的 ORS_API_KEY 在加载后会从进程环境中移除，并在错误消息中被屏蔽。

• OSM 来源的内容（名称、地址、标签）在工具结果中被标记为不可信数据，以便模型将其视为数据而非指令。

• 上游错误正文会被截断，HTML 错误页面在到达模型上下文之前会被丢弃。

• 从不跟随重定向；所有请求都有超时。

开发

npm install
npm run lint          # eslint + prettier
npm test              # unit tests (all upstream APIs mocked)
npm run test:coverage
npm run build
npm run smoke         # opt-in LIVE test against the real public services

发布

基于标签驱动，无需手动发布步骤：

1. 将 [Unreleased] 条目移至 CHANGELOG.md 中新的 ## [x.y.z] - YYYY-MM-DD 部分，并更新 package.json 版本号。

2. 运行 npm run lint && npm run build && npm run test:coverage。

3. 提交，然后创建一个带签名的注释标签：git tag -s vx.y.z -m "vx.y.z"。

4. 运行 git push origin main vx.y.z。

然后 release.yml 会运行测试，通过 Trusted Publishing（不涉及令牌密钥）将包发布到 npm 并附带来源信息，从 CHANGELOG 部分创建 GitHub 发布，并以 io.github.ni-c/osm-mcp 的名称发布到 MCP 注册表。ci.yml 会在同一标签上将多架构镜像推送到 GHCR。

如果注册表步骤失败，请在 main 分支上修复问题并触发 Publish to MCP Registry 工作流——不要重新运行标签作业，因为那样会检出旧的代码树。

许可证

MIT