Dutch Property Context

荷兰房产背景信息——荷兰地址 MCP 服务与 API

输入一个地址，获取一份与之关联的房产报告。包括 BAG 中的建造年份和面积、登记的能源标签、CBS 社区数据、环境噪音和空气质量、国家级文物建筑状态、受保护的城市或乡村景观，以及附近的学校。

既可作为远程 MCP 服务运行，也可作为普通 HTTPS API 使用。免费，无需 API 密钥，无需注册。

https://property-context.tradebrite.nl

📖 文档： https://tradebrite.nl/property-context/

---

10 秒内完成连接

Claude（网页版或桌面版，任何订阅方案）：Customize → Connectors → + → Add custom connector，粘贴 https://property-context.tradebrite.nl/mcp。

**ChatGPT：**自定义连接器需要 Developer Mode（Pro/Team/Enterprise/Edu）；Plus 无法使用——请改用 HTTPS API。

Claude Code：

claude mcp add --transport http property-context https://property-context.tradebrite.nl/mcp

或者在 MCP 配置中添加（Claude Desktop、Cursor、Windsurf，……）：

{
  "mcpServers": {
    "property-context": {
      "type": "http",
      "url": "https://property-context.tradebrite.nl/mcp"
    }
  }
}

然后你就可以提问：“去看房之前，我需要了解哈勒姆 Grote Markt 2 的哪些信息？”

更喜欢直接使用 HTTP：

curl "https://property-context.tradebrite.nl/v1/property/context?address=Grote%20Markt%202,%20Haarlem"

为什么要做这个

向 AI Agent 询问荷兰地址时，它会去网上搜索。得到的答案看起来不错，有时也确实准确。底层数据公开且可靠，但分散在九个登记系统中，每个系统都有自己的标识符、格式和特性。

最难的不是获取数据，而是关联数据。我们曾多次在这一步出错，后来才意识到问题：

• 我们发布的文物建筑编号，原来是内部对象编号。Prinsengracht 263 得到的编号，在文物建筑登记系统中指向的是泽里克泽的一栋建筑。
• 文物建筑查询没有按地点限定，所以阿斯滕的一个地址被关联到了库福尔登的一栋建筑。
• 查询 Binnenrotte 101, Amsterdam 时，系统毫无保留地返回了鹿特丹的一栋建筑，并标记为 match_verified: true。

没有任何数据源出错。出错的是数据关联。这一层接管了这项工作，并明确说明我们找到的是否确实是目标房产，以及我们对此有多大把握。

你会得到什么

一份 JSON 答案（约 11 kB），包含 identity、building、energy、location、neighbourhood、environment、heritage、protected_area、schools、signals 和 provenance。

注意 identity.match_verified。 如果其值为 false，则无法确定是否找到了请求的地址，答案的其余部分可能对应的是另一栋建筑。 如果存在 match_ambiguous，则会列出所有同样匹配的候选项。

signals 表示观察结果，绝不代表已确认的缺陷。建造年份为 1921 年并不意味着房屋有铅管——这意味着值得检查一下。

信号	含义
construction_era_checks	该建造年份区间通常应检查的事项
conflicting_construction_year	两个登记系统提供的建造年份不同；两者都会显示
energy_label_expiring / no_energy_label	已登记能源标签的状态
protected_townscape / world_heritage_area	对许可的影响
address_match_unverified	无法确定是否找到了请求的地址
source_unavailable	某个数据源未响应——数据未知，而非为空

它不提供什么

不提供房产估价、房屋价值，也不提供法律或建筑方面的建议。不提供要价、地租、业主协会（VvE）信息或所有权历史——这些信息并非免费公开。

设计原则

1. 绝不因某个值看起来可能正确就擅自补上缺失值。
2. 事实 ≠ 信号 ≠ 未知。
3. 每个来源都要注明出处，即使在 depth=compact 模式下也一样——部分来源采用 CC BY 许可，注明出处是许可条件。
4. **只用一个 MCP 工具，而不是几十个。**我们的工具列表长 2.419 个字符。我们对比过一个覆盖范围广的荷兰开放数据 MCP，64 个工具共 55.452 个字符。
5. 来源失效时，要明确显示失效状态。
6. 永远不会填充的字段，就不应该包含在内。

自行运行

npm install
python3 scripts/build_school_index.py     # bouwt data/schools.json
python3 scripts/build_amenities_index.py  # bouwt data/amenities.json
python3 scripts/build_places_index.py     # bouwt data/places.json
npx wrangler deploy                       # vul eerst je account_id in wrangler.toml
node regression.mjs                       # dertien gevallen tegen de live dienst

索引文件有意不放入仓库：它们由 CC BY 来源生成，几分钟内即可重新构建。EP_ONLINE_KEY（可向 RVO 免费申请）为可选项；没有该密钥时，仅缺少能源标签，并会妥善标记为 not_configured。

**注意软件包大小限制。**超过约 3,7 MB 后，Cloudflare Worker 的冷启动时间会从 0,2 秒升至 9 秒，/health 也不例外。我们已单独重新测量。因此，若不使用 R2，就无法再添加第四个索引。

来源与许可

BAG（Public Domain Mark 1.0）· EP-Online/RVO（自行适用的条款，不允许批量转供）· CBS Wijken & Buurten 和 Kerncijfers（CC BY 4.0）· RIVM 噪声和空气质量（公有领域）· RCE 国家古迹和保护区（CC BY 4.0）· DUO 教育机构地址（CC BY）。

**其中部分来源必须注明出处。**因此，每个响应都包含 provenance。向最终用户展示数据时，请一并提供该信息；这项义务会随数据一同转移。

**代码：**MIT，参见 LICENSE。

隐私

托管服务不会记录地址、邮政编码或 IP 地址。会记录：市镇（粗略粒度）、发出的信号以及来源状态。

相关项目

Dutch Vehicle Context——以同样的方式处理荷兰车辆：输入车牌，获取 APK 检查历史、反复出现的不合格项以及完整的召回链。

---

由 Tradebrite BV 构建 · [email protected]