Bbox Mcp Server

🌍 bbox-mcp-server

随时随地向 AI 提问，并在地图上验证答案。免费使用

面向 AI Agent 的地理空间工具包。6 个工具，零配置——让任何大模型都能使用开放数据查找、查询、转换和汇总空间数据。无需 API 密钥或注册即可开始使用。

每条响应都包含一个可分享的验证链接，指向 vibhorsingh.com/boundingbox——点击即可在交互式地图上直观确认结果。没有其他 MCP 服务能做到这一点。

你可以用它做什么？

**你不必是 GIS 专业人士也能使用它。**任何连接了此 MCP 服务的 AI Agent，都能使用真实的 OpenStreetMap 数据回答空间问题，而不是吐出一堆幻觉内容。

每个答案都附带一个链接。点击即可查看 AI 是否答对，你还可以把链接分享给其他人。

有何不同之处

大多数 AI 工具只提供需要你相信的文本。而这个工具提供交互式地图，让你检查并验证结果！

• 可验证——每条响应都包含一个公开 URL，你（或任何人）都可以通过它直观确认结果。这是唯一一个能在任何领域做到这一点的 MCP 服务。
• 确定性——查询直接访问真实的 OpenStreetMap 数据，并返回真实坐标。AI 负责解读你的问题，数据则来自所有了不起的 OSM 志愿者付出的努力。
• 免费——没有付费服务。Overpass API 免费，OSM 数据免费，工具也免费。Mapbox 令牌（免费套餐，无需提供付款信息）可启用自然语言地点搜索，但并非必需。
• 零配置——运行 npx -y bbox-mcp-server 即可开始使用。

为什么开发它

工具一览

所有工具都接受 location（自然语言，需要 Mapbox 令牌）或 bbox（坐标、WKT、GeoJSON 等）。

快速开始

将以下内容添加到 MCP 客户端配置中：

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

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

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

{
  "servers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"]
    }
  }
}

试试：“查找时代广场周围 500 米内的所有咖啡店”

可选配置

{
  "mcpServers": {
    "bbox": {
      "command": "npx",
      "args": ["-y", "bbox-mcp-server"],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "pk.your-token-here",
        "OVERPASS_API_URL": "https://your.custom.overpass.instance/api/interpreter",
        "NOMINATIM_API_URL": "https://your.custom.nominatim.instance"
      }
    }
  }
}

或全局安装：npm install -g bbox-mcp-server

工具参考

get_bounds

在 6 种输入格式、9 种输出格式和 3,900 多种坐标系之间转换并投影边界框。返回中心点以及质心的瓦片坐标。

💡 提示词： “获取中央公园的边界框，以 WKT 格式输出，并投影到 EPSG:32618”

get_h3_indices

生成覆盖边界框的 Uber H3 六边形网格单元索引。

💡 提示词： “为芝加哥市中心生成分辨率为 7 的 H3 网格单元，并包含六边形几何数据”

search_overpass

在边界框或半径范围内执行 Overpass 查询。返回包含名称、坐标和标签的结构化结果。验证链接会在地图上为每个结果标出图钉。

💡 提示词： “查找 JFK 机场 2km 范围内的所有停车场”

💡 提示词： “搜索曼哈顿的医院，限制为 50 个”

list_osm_tags

编写 Overpass 查询前，先查找某个类别对应的正确 OpenStreetMap 标签。

💡 提示词： “超市对应的正确 OSM 标签是什么？”

aggregate_overpass_h3

运行 Overpass 查询，并将结果归入 H3 六边形网格，以进行空间密度分析。返回每个网格单元的计数以及 GeoJSON 六边形边界。

💡 提示词： “将西雅图的所有医院按分辨率 7 汇总到 H3 网格中”

generate_share_url

生成可分享的链接，在 vibhorsingh.com/boundingbox 的交互式地图上显示边界框。

💡 提示词： “为 bbox 40.7128,-74.0060,40.7580,-73.9855 生成分享链接”

支持的输入格式

所有工具都会自动检测输入格式。无需指定所用格式。

🤖 面向 AI Agent 开发者

响应结构

每个工具都会返回两个内容块：

1. 人类可读文本 — 格式化的输出，包含地图验证链接
2. 结构化 JSON — 所有计算得出的数据，可供机器解析

get_bounds JSON 响应示例：

{
  "original_wgs84": { "lat1": 40.7128, "lng1": -74.006, "lat2": 40.758, "lng2": -73.9855 },
  "projected": { "xmin": -8238310.23, "ymin": 4970241.32, "xmax": -8235527.11, "ymax": 4976491.56 },
  "center": { "lat": 40.7354, "lng": -73.99575 },
  "tile_indices": { "z": 15, "x": 9660, "y": 12284 },
  "epsg": "3857",
  "coord_order": "lng,lat",
  "area_km2": 8.681,
  "dimensions": { "width_km": 1.714, "height_km": 5.066 },
  "share_url": "https://vibhorsingh.com/boundingbox/#40.712800,-74.006000,40.758000,-73.985500"
}

错误处理

所有错误都会返回 isError: true 和描述性消息。无效坐标、未知 EPSG 代码以及超出大小限制的 H3 请求都会返回清晰的错误 — 服务不会因错误输入而崩溃。

日志记录

结构化 JSON 日志会写入 stderr（stdout 保留给 MCP 协议）。每条日志都包含时间戳、级别和上下文。

致谢与合理使用

OpenStreetMap

此工具基于 OpenStreetMap 构建：这是一个由数百万志愿者创建并维护的全球数据集。你运行的每条查询都会返回有人亲自实地考察、绘制或核实过的数据。如果你觉得它有用，不妨考虑为 OSM 作出贡献。

负责任地使用

公开的 Overpass 和 Nominatim API 实例是容量有限的免费社区资源。请避免紧密循环、过度轮询或批量抓取。如果将其作为共享/远程 MCP 服务托管，请将 NOMINATIM_API_URL 和 OVERPASS_API_URL 指向你自己的实例或商业服务提供商（参见 Overpass API 安装 和 Nominatim 安装）。Overpass 的默认服务轮换有助于分散负载，但不能替代负责任地使用。

许可证

MIT