Yatmo neighbourhood data for real estate

Yatmo MCP 服务：为 AI 助手和 Agent 提供社区数据

Yatmo 通过远程 MCP 服务向 AI 客户端提供社区情报。连接 Claude、Cursor、VS Code 或你自己的 Agent，它就能基于真实数据回答“这处房产周边有什么？”，包括最近的学校、托儿所、超市、公共交通、火车站、高速公路入口、距离和出行时间，以及可引用的摘要段落，覆盖 25 个国家。

有两种使用方式：由 Yatmo 运营的托管服务，地址为 https://mcp.yatmo.com/mcp/v1（Streamable HTTP，无需安装）；或本仓库中的本地版本（npx -y @yatmo/mcp，stdio），它提供相同的四种工具，并使用你的密钥调用 Yatmo API。本仓库还提供可直接复制的客户端配置和快速入门指南。完整文档： Yatmo 文档。

四种工具

工具	返回内容
yatmo_get_location_summary	易读的社区概况段落，以及最近的学校、托儿所、超市、交通和反向地理编码所得地点
yatmo_get_nearby_pois	房产周边按顺序排列的兴趣点列表，可按类别筛选并指定半径
yatmo_get_nearest_by_category	某一类别中最近的地点及其距离和出行时间
yatmo_get_accessibility_profile	公共交通分布情况、最近的站点、火车站和高速公路入口

所有工具都接受 latitude、longitude、country（BE、FR、UK……）和 language，并返回相同的结构： text（助手可引用的摘要）、facts（结构化数据）、warnings 和 metadata。所有地方的类别都使用同一套词汇：school、nursery、supermarket、public_transport、train_station、motorway。 详情请参阅：工具参考。

身份验证

每个请求都会在 LicenceKey 标头中携带你的 Yatmo 后端密钥（也接受 LicenseKey）。请将密钥保存在客户端的机密存储中，切勿放在公开网页上：该密钥可访问你的 Yatmo 账户。请前往 yatmo.com 获取密钥；密钥说明。

连接客户端

通用远程 MCP 配置（configs/mcp.json），大多数客户端都支持，有时配置在名称略有不同的父键下：

{
  "mcpServers": {
    "yatmo": {
      "url": "https://mcp.yatmo.com/mcp/v1",
      "headers": { "LicenceKey": "YOUR_KEY" }
    }
  }
}

Claude.ai 和 Claude Desktop：依次选择 Settings > Connectors > Add custom connector，URL 为 https://mcp.yatmo.com/mcp/v1， 自定义标头为 LicenceKey: YOUR_KEY。启用连接器后，就会显示这四种工具。

Claude Code：

claude mcp add --transport http yatmo https://mcp.yatmo.com/mcp/v1 --header "LicenceKey: YOUR_KEY"

Cursor：将 configs/cursor/mcp.json 复制到项目中的 .cursor/mcp.json（或复制到 ~/.cursor/mcp.json，以供所有项目使用）。

VS Code（Copilot Agent 模式）：将 configs/vscode/mcp.json 复制到 .vscode/mcp.json。

你自己的 Agent（Anthropic、OpenAI 或任何大模型 SDK）：使用支持 Streamable HTTP 传输的 MCP 客户端库（TypeScript、Python、.NET、Go），将 LicenceKey 标头添加到传输中，并将四种工具定义转发给模型。quickstart.py 展示了不使用任何库的原始协议。

在本地运行（stdio）

适用于偏好本地进程的客户端，或用于查看代码：npm 上的 @yatmo/mcp，Node.js 18 或更高版本，以及两个依赖项（官方 MCP SDK 和 zod）。工具相同，JSON 响应也与托管服务相同；密钥从 LicenceKey 环境变量读取，且只会发送给 Yatmo API。

{
  "mcpServers": {
    "yatmo": {
      "command": "npx",
      "args": ["-y", "@yatmo/mcp"],
      "env": { "LicenceKey": "YOUR_YATMO_KEY" }
    }
  }
}

从克隆的仓库开始：运行 npm install，然后运行 LicenceKey=YOUR_YATMO_KEY node src/index.js。测试：运行 npm test（使用真实 API 响应检查映射）。无需密钥即可列出工具；不带密钥调用工具会返回 401 结构。

从命令行试用

export YATMO_KEY=your_backend_key
python3 quickstart.py          # initialize, list the tools, call yatmo_get_location_summary on a Brussels address
sh quickstart.sh               # the same three calls with curl

效果良好的提示词

• “比利时 50.8467, 4.3525 附近的社区环境如何？请用法语回答。”
• “距离此房源最近的小学和超市，以及步行所需时间。”
• “这个地址的公共交通是否便利？最近的火车站在哪里？前往高速公路是否方便？”
• “列出房产 800 m 范围内的兴趣点，仅包括学校和超市。”

助手根据工具的 text 和 facts 作答；距离会标明测量时所用的出行方式。

更多信息

• 快速入门、身份验证和错误代码、常见问题
• 网站也可使用相同的数据：插件、WordPress、Odoo、移动端 SDK、示例

本仓库中的文件采用 MIT 许可证。Yatmo 是一项面向房地产门户网站、中介机构网络和开发商的付费服务。

目录

此服务已发布到官方 MCP 注册表，名称为 com.yatmo/yatmo（本仓库中的 server.json），并已提交至 Docker MCP Catalog、Smithery 和 mcp.so。在能够读取注册表的客户端中，搜索“yatmo”或“real estate”。