Skip to main content
Glama
dutch-property-context

dutch-property-context

by rleefers

Dutch Property Context——荷兰地址的 MCP 服务器与 API

一个地址进去,一份经过关联的房产报告出来。建造年份和面积来自 BAG,还有已登记的能源标签、CBS 街区数据、环境噪音和空气质量、国家文物建筑状况、受保护的城市或村落风貌、以及附近的学校。

它既可以作为远程 MCP 服务器运行,也可以作为普通 HTTPS API 运行。免费,无需 API 密钥,无需注册。

https://property-context.tradebrite.nl

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


10 秒接入

Add dutch-property-context MCP server to Cursor

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"

Related MCP server: io.github.woonstadrotterdam/monumenten

为什么会有它

给 AI 智能体一个荷兰地址,它就会自己去网上找。最终答案看起来不错,甚至有时也准确。底层的数据是公开且可靠的,但它们分散在九类数据源,这些数据源各有各的键、格式和特色。

最难的并不是获取数据,而是关联、串联,而正是在这一环,我们多次翻车后才发现问题:

  • 我们公布的古迹编号,原来只是内部对象编号。Prinsengracht 263 获得的编号,在文化遗产登记册里指向的却是 Zierikzee 的某处房子。

  • 文化遗产查询没有限定位置,所以 Asten 的一个地址被错误关联到了 Coevorden 的古迹。

  • Binnenrotte 101, Amsterdam 会毫不犹豫地返回 Rotterdam 的这段房产,还带上了 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. 每个数据源都有来源(provenance),即使是在 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 明确表示。

注意 bundle 限制。 约 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。如果把这些数据展示给最终用户,仍请继续附上 provenance;这个义务会随着数据一起传递。

代码: MIT,见 LICENSE。

隐私

托管服务端不记录地址、邮编号码或 IP 地址。它记录的只是:城市/地区(粗粒度)、返回的信号,以及各个数据源的状态。

相关项目

Dutch Vehicle Context — 相同的设计模式,只是用于荷兰车辆:输入车牌,输出 APK 历史、重复出现的否决/检查呼声,以及完整召回链。


由 Tradebrite BV,上线 · info@tradebrite.nl

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables US address verification and standardization, validating deliverability and returning USPS-standardized data, plus property enrichment with 350+ tax assessor and deed attributes for a given address.
      282 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables cited site feasibility and pre-development project workflows for Canada and the US, returning lot, zoning, permitted uses, and material envelope details with provenance for a given street address.
      Apache 2.0