gaff-check

gaff-check

为 AI Agent 调查爱尔兰房产。

gaff-check 是一款开源的 MCP（Model Context Protocol） MCP 服务，可为 AI 助手——Claude、Cursor、ChatGPT 或任何兼容 MCP 的 Agent——提供来自爱尔兰分散公共房产数据集的真实信息。

询问你的助手：

“我应该竞拍这套位于 Killiney 的平房吗？告诉我所有需要注意的事项。”

……它就能在一次对话中查询：

• 🏗️ 房产附近的规划申请（后院后方那栋尚待审批的公寓楼）
• 💶 街道及周边地区的成交价（房产价格登记册）
• 🌊 洪水风险（OPW / GSI 洪水地图）
• ☢️ 氡气风险（EPA 氡气风险区域）
• 🗺️ 土地分区（Myplan 概括性土地用途分区）
• ⚡ BER / 能源评级背景及改造补助信号
• 🚓 所在 Garda 分区的已记录犯罪情况——类别数量和经过审慎说明的发生率，绝不提供安全评分

所有数据均来自爱尔兰官方公开数据集。不抓取商业房产网站。提供记录和明确标注的衍生背景信息，绝不编造确定性结论。

为什么要做

在爱尔兰买房（或翻新，或只是出于好奇）意味着要翻遍六个以上的政府网站；每个网站的用户体验都糟糕透顶，而且彼此互不连通。数据是公开的，综合分析却不是。gaff-check 就是连接这些数据的工具层：一个简单、可靠的工具，让 AI 助手来完成推理。

它不是什么

• 不是估价引擎。它返回记录；由你的 Agent 进行思考。
• 不是 Daft/MyHome 抓取器。只使用公共部门数据。
• 不是网站，而是为你已在使用的工具提供增强功能的实用工具。

快速开始

gaff-check 以 stdio MCP 服务的形式运行，需要 Node.js 20 或更高版本。不要单独运行 npx -y gaff-check：它会等待 MCP 客户端发送请求，因此终端看起来会卡住。请将它添加到你的助手中；无需 API 密钥或单独安装软件包。

Claude Code：

claude mcp add --transport stdio --scope user gaff-check -- npx -y gaff-check

在 Claude Code 中运行 /mcp，确认 gaff-check 已连接。--scope user 会让它在所有项目中都可用；如果希望使用 Claude Code 默认的项目本地配置，请省略该选项。

Codex：

codex mcp add gaff-check -- npx -y gaff-check

运行 codex mcp list 确认已配置该服务，然后启动新的 Codex 会话并使用 /mcp 检查当前启用的工具。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "gaff-check": { "command": "npx", "args": ["-y", "gaff-check"] }
  }
}

效果示例

你： 我在考虑都柏林 2 区 Fitzwilliam Square 附近的一栋 20 世纪 80 年代建造的房子。有哪些需要了解的？

Claude （调用 resolve_location、planning_applications、sold_prices、radon_risk、zoning、flood_risk、ber_context、recorded_crime_context）：

以下是该区域的公开记录信息：

• 规划： 300 米范围内有 5 项以上申请——最近一项是于 2025 年 2 月获批的受保护建筑改造申请（都柏林市议会，编号 WEB1305/25，距离 81 米）。广场本身有多个受保护建筑改造先例。
• 成交价： 附近近期登记的房屋成交价差异很大；登记簿会列出每个地址申报的确切价格（例如，Howth Road 一套半独立式住宅于 2026 年 6 月以 180 万欧元成交——每条记录都包含日期、地址和 VAT 标记）。
• 氡： 该区域属于爱尔兰环保署（EPA）的“约 20 户中有 1 户”风险等级——并未划为高氡区域，但 EPA 建议对任何房屋进行检测（约 50 欧元）。
• 分区： 根据《都柏林市发展规划 2022–2028》，广场本身划为开放空间；周边街道则为住宅／混合用途。
• 洪水： 该地点没有已绘制的地下水或历史洪水范围——但请注意，OPW 的河流／沿海模型受许可限制，未进行核查；请在 floodinfo.ie 核实。
• BER 背景信息： 都柏林 2 区 1978–1999 年建成的住宅评级多为 C／D。如果房源信息声称评级为 B，请要求查看证书。目前 SEAI 补贴：热泵最高 12,500 欧元，半独立式住宅的阁楼保温补贴为 1,300 欧元（已于 2026 年 7 月核实）。
• 已记录犯罪： 包含该地点的 Garda 次级辖区年度 CSO 类别计数，以及单独标注的较大辖区趋势。这些是行政区域总数，并非该地址发生的案件；次级辖区层级不公布凶杀案和性犯罪数据。

以上所有数据均来自官方数据集，载荷中附有来源、许可、版本信息和注意事项。

开始动手

git clone https://github.com/iarfhlaith/gaff-check.git
cd gaff-check
npm install && npm run build

该代码库附带面向项目的 .mcp.json，供 Claude Code 使用；以及 .codex/config.toml，供 Codex 使用。构建完成后，打开并信任该代码库，然后在出现提示时批准或重启已配置的服务。npm test 会运行基于固定测试数据的单元测试；RUN_E2E=1 npm run test:e2e 和 npm run eval 会访问在线上游服务。

有关项目风格，请参阅 CONTRIBUTING.md；有关简明的运行说明，请参阅 docs/HANDOVER.md；有关权威信息的详细来源，请参阅 SPEC.md 和 docs/DATA_SOURCES.md。

状态

已在 npm 上发布，版本为 [email protected]。目前可用：

工具	可解答的问题	来源
resolve_location	“这个地址的确切位置在哪里？”	OpenStreetMap Nominatim
planning_applications	“这个地点附近有哪些申请或审批记录？”	National Planning Application Database (DHLGH)
sold_prices	“这里的房屋实际卖了多少钱？”	Property Price Register (PSRA，官方 CSV)
radon_risk	“这里属于氡气高风险区域吗？”	EPA Radon Risk Map
zoning	“这块土地的规划用途是什么？”	Myplan generalised zoning (DHLGH)
flood_risk	“这里有已绘制的地下水或历史洪水风险吗？”	GSI 洪水地图（并提供 OPW 的 floodinfo.ie 链接，供查询河流和沿海模型；这些模型受许可限制）
ber_context	“这里这个年代的房屋，通常 BER 等级如何？有哪些补助？”	CSO BER 统计数据（EBA02）+ SEAI 补助参考数据
recorded_crime_context	“这个更广泛的 Garda 区域公布了哪些已记录犯罪类别？”	CSO CJA11/CJA39/CJQ10/CJQ11 + Garda 边界 + Census 2022 分母

全部八个工具均已实现。目前的重点是发布后的可靠性、检测上游数据变化，以及及时更新来源、许可和补助元数据；请参阅 docs/LAUNCH.md 中的监控清单。

关于 Eircode 的说明： Eircode 查询属于专有服务，因此没有免费的官方方式可将 Eircode 转换为坐标。如果你只有 Eircode，请同时向助手提供地址（或大致位置）——其余工作由 resolve_location 处理。

相关先例

irishmcp.ie 提供了一个仅支持 PPR 的 MCP 服务，基于 CivicTech Ireland 的 price-register API 构建——做得不错；如果你只需要成交价，不妨看看。gaff-check 的范围更广（规划、洪水、氡气、分区和 BER 背景信息），并直接读取 PSRA 官方 CSV。

许可证

MIT。工具返回的数据受底层公共数据集的许可约束（大多为 CC-BY 4.0 / PSI）——请参阅 DATA_SOURCES.md。