overpass.ch

overpass.ch MCP 服务

托管的 Overpass API，配有 MCP 服务。连接到它的 AI 助手可以查询整个地球的 OpenStreetMap 数据、按名称查找地点、查询海拔，并根据最新数据作答。

数据涵盖 OpenStreetMap 中绘制的每条街道、每家商店、每栋建筑和每个地点，并每分钟更新一次。Medium 和 Large 套餐还可以查询过去日期的地图数据，最早可追溯至 2012 年 9 月。

此代码库包含托管服务的文档和注册表条目，服务地址为 https://api.overpass.ch/v1/mcp。无需安装任何内容。

• 网站：https://overpass.ch
• 设置指南：https://overpass.ch/guides/overpass-mcp-server
• 文档：https://overpass.ch/docs#mcp
• 官方 MCP Registry：ch.overpass/overpass

设置

1. 在 https://overpass.ch/signup 创建免费账户和 API 密钥。

2. 将服务添加到你的助手中，可以使用包含密钥的 URL：

   https://api.overpass.ch/v1/YOUR_API_KEY/mcp
   

   或使用 https://api.overpass.ch/v1/mcp，并在 X-API-Key 标头中提供密钥（或使用 Authorization: Bearer YOUR_API_KEY）。

传输方式：Streamable HTTP。协议版本为 2026-07-28 和 2025-03-26 至 2025-11-25。列出工具无需密钥。为每个助手单独创建一个密钥，以便单独撤销。

Claude（网页版、桌面端和移动应用）

Customize → Connectors → + Add → Add custom connector。名称：overpass.ch。URL：包含密钥的 URL。身份验证：No sign in。

ChatGPT

打开 https://chatgpt.com/plugins，选择 + 和 Add custom MCP server。输入名称，在 Connection 下输入包含密钥的 URL，并选择不进行身份验证。确认警告，然后选择 Create as a plugin。你的 ChatGPT 套餐或工作区必须允许使用自定义 MCP 服务。

Claude Code

claude mcp add --transport http overpass https://api.overpass.ch/v1/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Cursor

在 ~/.cursor/mcp.json 中配置，并将密钥放入环境变量 OVERPASS_KEY：

{
  "mcpServers": {
    "overpass": {
      "url": "https://api.overpass.ch/v1/mcp",
      "headers": { "X-API-Key": "${env:OVERPASS_KEY}" }
    }
  }
}

VS Code

.vscode/mcp.json。VS Code 会在首次使用时询问密钥并保存：

{
  "inputs": [
    { "type": "promptString", "id": "overpass-key", "description": "overpass.ch API key", "password": true }
  ],
  "servers": {
    "overpass": {
      "type": "http",
      "url": "https://api.overpass.ch/v1/mcp",
      "headers": { "X-API-Key": "${input:overpass-key}" }
    }
  }
}

其他客户端

其他通过 Streamable HTTP 使用 MCP 的客户端可以使用包含密钥的 URL，也可以使用不含密钥的 URL，并通过 X-API-Key 标头传入密钥。

作为 Agent 插件

此代码库也是一个 Agent 插件：plugin.json 和 mcp.json 会将服务 overpass 添加到 https://api.overpass.ch/v1/mcp。插件无法携带你的密钥，因此请在客户端设置中为服务 overpass 添加包含密钥的 X-API-Key 标头。没有密钥时，工具仍会列出，但每次调用都会提示缺少密钥。

工具

工具	功能	计费方式
overpass_query	在整个地球范围内运行 Overpass QL 或 XML 查询。答案以数据条数和日期开头，然后每行列出一个元素。超过 30,000 个字符的答案会被截断，可通过 offset 分段读取。	1 次请求
overpass_examples	从包含 99 个查询的示例集里查找经过测试的主题查询示例。	免费
geocode_search	按名称查找地点、地址和兴趣点，支持英语、德语或法语，并提供 overpass_area_id，用于在该地点范围内搜索。	1 次地理编码请求
geocode_reverse	查询某个点所在的地址、街道、城市或国家。	1 次地理编码请求
elevation_points	查询点位海拔：瑞士和列支敦士登采用 2 m 网格（swissALTI3D），其他陆地地区采用 30 m 网格（Copernicus），海上查询水深（GEBCO）。	每个点 1 次查询
elevation_profile	查询路径沿线的距离、爬升、下降和海拔。	每个采样点 1 次查询
account_status	套餐、本月用量和数据日期。	免费

所有工具都只读取数据。通过 MCP 执行的 Overpass 查询最多在 120 秒后停止。

示例问题

• 苏黎世有多少家药店位于电车站 200 m 范围内？
• 瓦莱州有哪些山间小屋海拔超过 2,500 m？
• 列出伯尔尼州的所有电动汽车充电桩，并以表格形式显示运营商和功率。
• 洛桑在 2015 年有多少家咖啡馆？如今有多少家？（Medium 和 Large 套餐）

套餐

工具调用计数方式与 REST API 调用相同。

套餐	月费	每月 Overpass 请求数	同时查询数	历史记录
Free	0	10,000（每分钟 30 次）	1	否
Small	CHF/EUR 19 或 USD 25	100,000	2	否
Medium	CHF/EUR 59 或 USD 79	1 million	6	是
Large	CHF/EUR 149 或 USD 199	3 million	10	是

Free 套餐适用于评估和开发，以及个人、教育和非营利项目；商业用途需要付费套餐。每个套餐每月均包含 100,000 次地理编码请求。价格不含 VAT，年费相当于支付十个月的费用。详情：https://overpass.ch/pricing

常见问题

我需要 API 密钥吗？ 需要，调用工具时需要。Free 套餐即可使用。无需密钥即可查看工具列表。

结果非常大时会怎样？ 答案会说明结果包含多少个元素。助手可以使用 offset 读取下一部分，将 max_chars 提高至 200,000，或缩小查询范围（out count;、out center 50;、缩小区域）。

这与使用 overpass-api.de 的 MCP 服务有何不同？ 公共服务 overpass-api.de 对任何定期运行的内容每天允许大约 100 次查询，会拒绝未提供自有 User-Agent 的脚本，并会在多次出现 429 错误后封禁相关地址。overpass.ch 使用 API 密钥识别用户，公开其限额，并在达到限额时告知助手需要等待多久。

会记录哪些内容？ 工具调用的记录方式与 API 请求相同：记录密钥的 ID，但绝不记录密钥本身；查询仅以哈希形式记录。

数据与许可

数据 © OpenStreetMap 贡献者，依据 Open Database Licence 提供（https://www.openstreetmap.org/copyright）。瑞士和列支敦士登的海拔数据 © swisstopo。overpass.ch 在瑞士运营，服务器位于芬兰（EU）。联系方式：https://overpass.ch/contact