Monumenten

Monumenten MCP 服务 🏛️

一种模型上下文协议（MCP）服务，可让 AI 助手查询与 woningwaardering（租金积分系统）相关的荷兰地址是否具有文物保护身份。它连接荷兰 BAG（地址和建筑物基本登记系统）数据与文化遗产部（Rijksdienst voor het Cultureel Erfgoed），用于识别国家级文物、国家保护的城市景观和市级文物。

基于 MCP Python SDK v2（MCPServer）构建。工具会返回结构化结果；验证或查询失败时会抛出 ToolError（is_error=true），以便模型重试。

需要 Python 3.11+。

说明

此 MCP 服务基于 monumenten 软件包。如需了解更多信息，请参阅 monumenten 软件包。

功能

此 MCP 服务可让 AI 助手：

• 🏠 查找 verblijfsobject ID - 将荷兰地址转换为 BAG 标识符（verblijfsobject_id）
• 🏛️ 查询文物保护身份 - 确定某处房产是否受文化遗产保护
• 📍 灵活输入地址 - 按邮政编码 + 门牌号或完整地址搜索
• 🔍 处理不同的地址格式 - 支持门牌字母和后缀（30A、30-2 等）

可用工具

工具	参数	结果
get_verblijfsobject_id	house_number、postal_code 或 street + house_number + city，可选的 house_letter、house_suffix	BAG verblijfsobject 记录的结构化 matches 列表
get_monumental_status	bag_verblijfsobject_id（16 位数字）	结构化的文物保护状态（省级文物、国家级文物、国家保护的城市／乡村景观、市级文物；provinciaal_monument 始终为 null）

快速配置

将其添加到 AI 助手的 MCP 配置中：

{
  "mcpServers": {
    "monumenten": {
      "command": "uvx",
      "args": ["mcp-monumenten"]
    }
  }
}

本地开发：

{
  "mcpServers": {
    "monumenten": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/mcp-monumenten", "mcp-monumenten"]
    }
  }
}

默认情况下，Streamable HTTP（mcp-monumenten --http）会监听 http://127.0.0.1:8000/mcp。

Claude Code 插件

需要 uv。然后：

/plugin marketplace add woonstadrotterdam/mcp-monumenten
/plugin install monumenten@woonstad-rotterdam

也可以直接添加服务：claude mcp add monumenten -- uvx mcp-monumenten。

使用示例

查询文物保护身份

“Coolsingel 30, Rotterdam 的文物保护身份是什么？”

AI 将会：

1. 将地址转换为 BAG verblijfsobject ID
2. 查询文物登记信息
3. 报告其是否为国家级文物、国家保护的城市／乡村景观或市级文物

“1234AB 30-2 是国家级文物吗？”

AI 可以处理：

• 邮政编码 + 门牌号格式
• 门牌号后缀（30-2、30A 等）
• 直接查询 verblijfsobject ID

灵活输入地址

此服务支持以下荷兰地址格式：

• 1234AB 30 - 基本的邮政编码 + 门牌号
• 1234AB 30-2 - 带门牌号后缀
• 1234AB 30A - 带门牌字母
• Coolsingel 30, Rotterdam - 完整街道地址

安装

通过 uvx 安装（推荐）

uvx mcp-monumenten

本地开发

git clone https://github.com/woonstadrotterdam/mcp-monumenten.git
cd mcp-monumenten
uv sync
uv run --project . mcp-monumenten

数据源

• Kadaster - BAG（Basisadministratie Adressen en Gebouwen） - 荷兰官方地址登记系统
• RCE（Rijksdienst voor het Cultureel Erfgoed） - 国家古迹登记系统

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。