PlaceRoot 是一个 MCP 服务器，把 AI 智能体接入 Overture Maps 的开放地图数据，用来回答空间问题，比如附近有什么、某个街区里有什么、如何到达某地。它不需要 API 密钥、注册账号或供应商平台，是 vibemapper 的一个独立项目。
主要能力与特点：
- 返回经过排序的紧凑结果，而不是原始 GeoJSON 数据转储，适合智能体的上下文窗口。
- 提供真实路径规划：route 和 isochrone 基于 Overture 交通路段构建的实际街道图行走，覆盖全球，而不是直线距离估算。
- 支持可达范围过滤搜索：find_places(..., within={"minutes": 15, "mode": "walk"}) 只保留真正落在街道图步行、骑行或驾车可达范围内的结果，而不是用半径猜测或自己再做多边形相交。
- 地点数据丰富且可过滤，包含类别、品牌、置信度、营业状态、可联系性等，来源是 Overture 开放数据集（由 Meta、Uber、TomTom 等贡献）。
- 边界精确：可以在具名地点的真实行政多边形内搜索，而不是猜测的圆形半径。
- 零配置：直接读取 Overture 的公共数据，除了服务器本身无需安装其他东西。
使用方式： 可以直接从 PyPI 或 npm 运行，无需安装步骤。把配置加入 claude_desktop_config.json，或使用 npm 时配置 "command": "npx"、"args": ["placeroot"]。然后就可以向智能体提出空间类问题，例如“帕洛阿尔托市中心周围有什么”“比较这两个街区的自行车店”“规划我的办事路线：药店、五金店、邮局”。
工具与配置： 共 48 个工具，分为四个系列，每个答案都控制在几千 token 以内。还提供七个工作流提示（选址、街区比较、办事规划、是否适合居住、了解我的城市、核实房源描述、规划区域访问）和三个可附加资源；通过 PLACEROOT_TOOLS 设置可以只加载需要的工具配置，最多减少 95% 的 schema 开销。完整工具目录、提示、资源和配置见 docs/REFERENCE.md。
适用场景： 适合需要空间推理的 AI 智能体，例如本地生活服务、选址分析、街区比较、出行办事规划等。
限制： 开放数据有明确边界——没有实时路况、没有营业时间、没有评分或照片。这些是 PlaceRoot 有意不做的部分。
技术细节： 它是唯一一个对全球开放地图数据做真实图路径规划的无密钥 MCP 服务器；每个工具都声明了恰当的 MCP 注解，让客户端在提示用户前知道哪些调用是只读的。稳定的 GERS ID 让智能体可以跨轮次保持地点；本地缓存让重复查询在毫秒级返回，并可离线工作；整个项目可端到端自托管。
与 Mapbox MCP 和 Google Maps MCP 的对比基准及 token 效率数据见项目文档。
休闲地点覆盖： Overture 的 places 主题源自商业列表，因此对企业强、对家庭周末常去的地点（游乐场、社区公园、狗公园、海滩）覆盖较薄。这些要素并非缺失，而是位于另一个主题。Overture 的 base 主题直接合并了 OpenStreetMap，PlaceRoot 已经在 land_use_at 和 infrastructure_at 中查询它，places 工具默认也会读取它。不需要下载、构建或托管，只是对同一公共 Overture 发布版多做一次实时扫描，大约能将游乐场覆盖扩大 2.5 倍（在纽约市，按 2026-07-22.0 发布版测量，1,552 对 674；计数会随发布版漂移，其中 1,013 个距离任何 places 主题游乐场超过 150 米）。所有 places 工具会同时从两者作答，工具、响应结构、类别过滤器都不变。代价是每次 places 查询多扫描一个数据集（同样有缓存），且这些行没有置信度或营业状态，往往没有名称——未命名游乐场会返回 name: null，而不是被丢弃。如果更看重延迟而不是覆盖，可以调整配置。data_version 在层激活时会报告该层。详细说明（包括为何实测并拒绝实时 Overpass 查询和原始 OSM Parquet）见 docs/RECREATION.md。
开发与文档： 开发设置、设计规则和提议工具的方法见 CONTRIBUTING.md。其他文档包括 CHANGELOG、SECURITY、publishing、website、运行数据镜像、休闲层。联系邮箱 hello@placeroot.dev。
隐私： PlaceRoot 在你的机器上运行——没有账号、没有 API 密钥、无需注册。它没有遥测数据，不会向我们发送任何内容；唯一的网络流量是你自己的查询直接发往 AWS S3 上的 Overture Maps 公共数据（或你配置的镜像）。详情见 placeroot.dev/privacy.html。
许可与署名： 代码为 MIT 许可。查询的数据是 Overture Maps 公共发布版，按主题许可——places 采用 CDLA-Permissive-2.0；源自 OSM 的主题（divisions、transportation、base）采用 ODbL，要求你在构建的任何面向用户的内容中署名：© Overture Maps Foundation · © OpenStreetMap contributors（ODbL）。各主题义务见 docs/DATA-LICENSE.md。
MCP 名称：io.github.chuofringer/placeroot。
