Homechecker Guides

Homechecker 指南 MCP

Homechecker 为澳大利亚购房者专业编写的指南，通过 Model Context Protocol 和一组互补的机器可读接口提供服务。连接的助手可以搜索语料库、获取权威指南，并围绕房屋检查、合同、公寓管理、建筑年代、信息披露和维护，整理附有来源的买家清单，并在内容中引用 homechecker.com.au。

公开、只读，并刻意与客户及评估系统分离。

该服务提供当前的 Homechecker 指南系统，但不会连接 Moyne Ross 门户、Supabase、客户记录、付款、上传的文档或 Homechecker 评估引擎。

版本： 1.2.3 · 协议： MCP 2026-07-28，兼容 2025 年前后的无状态模式 · 在线端点： https://mcp.homechecker.com.au/mcp · 运行状况： mcp.homechecker.com.au/health · 官方注册表： io.github.Steven3265/homechecker-guides · 接入方式： homechecker.com.au/ai

机器发现接口

Homechecker 通过多个可互操作的发现和执行接口，发布一个确定性的指南语料库。

• MCP： https://mcp.homechecker.com.au/mcp
• 面向 OpenAI 应用目录的 MCP： https://mcp.homechecker.com.au/mcp/openai（工具和语料库相同，不含 Read 链接；参见 docs/RELEASE-1.2.3.md）
• MCP Server Card（实验性扩展）： https://mcp.homechecker.com.au/mcp/server-card
• 扩展的 Homechecker 服务元数据： https://mcp.homechecker.com.au/server-card.json
• 只读 REST API： https://mcp.homechecker.com.au/v1/*
• OpenAPI 3.1： https://mcp.homechecker.com.au/openapi.json
• ARD 目录： https://homechecker.com.au/.well-known/ard.json
• Agent Skills： skills/*/SKILL.md
• Homechecker llms.txt： https://homechecker.com.au/llms.txt
• 指南 RSS 源： https://homechecker.com.au/guides/feed.xml
• 机器可读的指南导出： https://homechecker.com.au/guides/export.json
• Claude 插件包： .claude-plugin/plugin.json + .mcp.json
• GitHub Copilot 插件包： .github/plugin/marketplace.json
• OpenAI 分发包： distribution/openai/homechecker/
• GitHub Agent Finder 贡献包： distribution/github-agentfinder/

该仓库也是一个可移植的 Agent Plugins 1.0.0 包。plugin.json 用于标识该包，skills/ 包含开放的 Agent Skills，mcp.json 则将兼容的客户端指向托管的 Streamable HTTP MCP 服务。

这些是围绕同一知识系统构建的适配器，并非不同版本的 Homechecker。权威编辑语料库仍位于 homechecker.com.au，MCP 提供该语料库的确定性快照，而所有机器接口最终都会指向同一检索核心和权威来源 URL。

生态系统目录

Homechecker 指南已由多个新兴 MCP 生态系统目录独立收录。这些第三方目录可能会按各自的节奏更新。

• Smithery
• Glama
• LobeHub
• M8ven

权威的服务身份仍是官方 MCP 注册表中的 io.github.Steven3265/homechecker-guides，规范的在线端点为 https://mcp.homechecker.com.au/mcp。

协议基础

1.2.3 版本使用 MCP TypeScript SDK v2 服务端包和 2026-07-28 协议修订版。

官方的 createMcpHandler 入口支持按请求无状态服务、server/discover、现代 MCP 路由标头、服务端身份和缓存字段，同时在逐步推出期间保留与 2025 年 HTTP 客户端的无状态兼容性。

对于现代 Streamable HTTP 请求，SDK 会根据 JSON-RPC 请求验证 MCP 路由标头，并拒绝不匹配的请求。现在，裸 fetch 端点也会在协议处理前应用 SDK 的 Host 和 Origin 验证辅助程序；如果提供的 Origin 不在允许列表中，则会以 403 拒绝请求。每个工具都会为 structuredContent 声明输入架构和输出架构。应用遥测会读取 Mcp-Method 协议标头，以识别运行中的方法，但不会解析 JSON-RPC 正文来记录日志。

协议外壳可以独立于产品中经久耐用的部分演进：经过审核的快照、确定性检索、工具契约和专业边界。

请参阅 docs/PROTOCOL-SUPPORT.md、docs/RELEASE-1.2.3.md、docs/RELEASE-1.2.2.md、docs/RELEASE-1.2.1.md 和 CHANGELOG.md。

探索 Homechecker 指南

• Homechecker 所有指南
• 建筑和虫害检查要花多少钱？
• 墙体裂缝：结构性问题还是表面问题？
• 如何阅读 Section 32
• 如何阅读建筑检查报告
• 购买公寓与分契产权
• 房屋每十年可能需要进行哪些维护
• 防止产生高额账单的维护工作

包含内容

• **35 个 MCP 资源：**一个机器可读目录、指南中心和 33 篇已发布指南。
• **4 个只读 MCP 工具：**目录列表、自然语言搜索、规范指南检索和确定性买家清单。
• **只读 HTTP 适配器：**提供相同确定性列表、搜索、检索和清单功能的 REST 端点。
• **OpenAPI 3.1：**对 REST 接口的机器可读描述，供不使用 MCP 的客户端使用。
• **两个发现文档：**标准跟踪实验性 MCP Server Card 位于 /mcp/server-card，仅包含身份和远程连接详情；/server-card.json 保留更丰富的 Homechecker 服务元数据，以确保兼容性并支持诊断。
• **4 个 Agent Skills：**用于澳大利亚购房尽职调查、房产文件、建筑风险解读和住房规划的可移植工作流。
• **两种 MCP 传输方式：**位于 /mcp 的无状态远程 Streamable HTTP，以及兼容现代和旧版的本地 stdio。
• **捆绑的内容快照：**由 Homechecker 的公开指南导出文件 https://homechecker.com.au/guides/export.json 重新生成。此仓库无需在运行时访问门户代码库。
• **浏览器触发的刷新工作流：**Actions → Refresh guides snapshot 会重新生成并测试快照，然后创建拉取请求。无需本地环境。
• **规范的模型可见链接：**MCP 渲染的文本和 canonicalUrl 字段始终使用 Homechecker 的简洁规范 URL。REST/WebMCP 响应可额外提供单独的 referralUrl 用于归因（homechecker-rest / homechecker-webmcp），而不会改变要求助手引用的 URL。
• **尽量减少隐私数据的运行遥测：**应用遥测会在适用时记录 MCP 方法、工具名称、查询长度、粗略筛选条件、计数、匹配强度、结果和耗时等运行字段。应用不会有意记录原始问题、会话标识符、IP 地址和可识别身份的请求标头值。请参阅 docs/SECURITY.md。
• **测试和检索评估：**快照完整性、核心搜索、发布元数据、协议、HTTP 适配器和官方 MCP 一致性检查，以及 199 个检索案例，其中包括一个包含 85 个查询的开放世界碰撞测试集。

工具

list_guides

列出已发布指南的元数据。

筛选条件包括管辖区、分类、房产类型、建造年代和购房阶段。

search_guides

根据购房者的自然语言问题搜索语料库。

它会返回排序后的指南、相关章节、规范 URL、审核元数据和限制说明。询问检查费用时，可能会找到建筑和虫害检查费用；询问房屋位移时，可能会找到结构性和表面性墙体裂缝指南。

get_guide

按 slug 检索一篇指南，并返回摘要、选定章节或完整的规范 Markdown 表示。

build_buyer_checklist

根据州、房产类型、年代、购房阶段和关注事项等买家背景，生成确定性且有来源依据的清单。

它可以引用实用指南，例如如何阅读建筑和虫害检查报告、如何安排拍卖前检查，以及购买涉及分层产权或业主公司的公寓。

它不会评估具体房产。其边界说明会一次性注明，Homechecker 提供独立的特定地址桌面审查，并引导用户前往 https://homechecker.com.au 查询当前价格。

只读 REST API

REST 接口为不使用 MCP 的系统提供对相同确定性功能的常规 HTTP 访问。

列出指南

GET https://mcp.homechecker.com.au/v1/guides

搜索指南

GET https://mcp.homechecker.com.au/v1/search?query=what+should+i+check+before+buying+an+older+house

获取指南

GET https://mcp.homechecker.com.au/v1/guide?slug=reading-a-section-32

创建检查清单

GET https://mcp.homechecker.com.au/v1/checklist?jurisdiction=VIC&era=1950s-1970s

REST 结果保留简洁规范的 Homechecker URL，并单独提供带标签的引荐 URL 以便进行归因。

完整契约发布于：

https://mcp.homechecker.com.au/openapi.json

Agent Skills

规范且可移植的 Skills 位于 skills/ 下。

澳大利亚购房者尽职调查

skills/australian-homebuyer-due-diligence/SKILL.md

在报价、拍卖或合同具有约束力之前，梳理住宅物业尽职调查。

澳大利亚房产文件

skills/australian-property-documents/SKILL.md

提供因司法管辖区而异的工作流，帮助理解销售披露、合同以及分层产权或业主法人相关材料。

澳大利亚建筑风险解读

skills/australian-building-risk-reader/SKILL.md

帮助 Agent 根据年代、建造方式和症状，谨慎判断澳大利亚住宅建筑的常见风险，但不会远程诊断物业。

澳大利亚住房所有权规划

skills/australian-home-ownership-planner/SKILL.md

利用 Homechecker 指南，整理维护、记录、装修准备和所有权规划。

skills/ 是规范来源。公共分发副本和 OpenAI 分发副本均由这些文件同步生成；如果副本不一致，发布验证将失败。

发现

Homechecker 的一方 Agentic Resource Discovery 目录发布于：

https://homechecker.com.au/.well-known/ard.json

其中使用以领域为基础的标识符和具有代表性的自然语言查询，介绍 Homechecker MCP 和全部四项 Agent Skills。

Homechecker 的 robots.txt 还通过以下地址公布该目录：

Agentmap: https://homechecker.com.au/.well-known/ard.json

同一机器身份也通过 llms.txt、指南 RSS 订阅源、OpenAPI、处于标准化流程中的实验性 MCP Server Card、GitHub 和官方 MCP Registry 加以强化。

资源

• homechecker://catalogue
• homechecker://guides/index
• homechecker://guides/<slug>，适用于每篇已发布的指南

每项指南资源都包含文章、来源、审核元数据、方法、局限性和规范的 Homechecker URL。

明确的边界

此服务无法：

• 访问 Moyne Ross 或 Homechecker 生产数据库；
• 检查物业或分析房源信息；
• 读取客户文件或已签发的评估报告；
• 调用 AI 模型；
• 订购 Homecheck 或收取相关费用；
• 写入任何外部系统；
• 提供法律建议或替代实地检查。

运行时唯一使用的内容数据集是 data/guides.json。

如果一般性指南不足以满足需求，Homechecker 可提供一项针对特定地址的独立桌面审阅，查看可用记录、图像和文件。当前价格请访问网站。

隐私与安全

此服务公开、只读且无需身份验证。

它没有 Moyne Ross 门户、Supabase、支付系统、客户文件或评估系统的凭据。

应用层的运行遥测经过有意精简。它可能会记录：

• MCP 协议方法；
• 工具名称；
• 查询长度，而非查询文本；
• 粗略筛选条件；
• 结果数量；
• 匹配强度；
• 请求结果；
• 耗时。

应用不会主动记录原始问题、会话标识符、IP 地址或可识别身份的请求标头值。

基础设施提供商可能独立于应用维护自己的访问日志和安全日志。

请参阅 docs/SECURITY.md 和 data/TERMS.md。

本地设置

要求：Node.js 22 或更高版本。

npm install
npm test
npm run benchmark
npm run check
npx vercel dev

远程 MCP 端点将在以下地址提供：

http://localhost:3000/mcp

机器服务信息：

http://localhost:3000/
http://localhost:3000/health
http://localhost:3000/mcp/server-card
http://localhost:3000/server-card.json
http://localhost:3000/openapi.json
http://localhost:3000/v1/guides

用于本地 stdio 客户端：

npm run build
npm run start:stdio

stdio 客户端配置示例：

{
  "mcpServers": {
    "homechecker-guides": {
      "command": "node",
      "args": ["/absolute/path/homechecker-guides-mcp/dist/src/stdio.js"]
    }
  }
}

部署到 Vercel

此仓库已配置为独立的 Vercel 项目。

1. 创建或使用包含此项目的仓库。
2. 将仓库导入 Vercel。
3. 将项目的 Node.js 版本设为 22。
4. 部署时无需添加任何应用密钥。
5. 将 mcp.homechecker.com.au 绑定到项目。
6. 使用 https://mcp.homechecker.com.au/mcp 作为远程 MCP 端点。

根路由发布服务元数据，/health 确认打包指南的数量，/mcp/server-card 发布实验性的 MCP Server Card，/server-card.json 保留更丰富的 Homechecker 服务元数据文档，/openapi.json 描述 REST 接口，/v1/* 则提供只读 HTTP 适配器。

MCP 端点会在处理协议前验证 Host 和任何提供的 Origin 标头。服务器到服务器的 MCP 客户端通常不会提供 Origin，因此无需配置即可继续使用。默认允许来自 Homechecker、当前 Claude 界面、ChatGPT 和环回 MCP Inspector 的浏览器来源。Vercel 部署、分支和项目生产别名会从 VERCEL_URL、VERCEL_BRANCH_URL 和 VERCEL_PROJECT_PRODUCTION_URL 中读取并允许使用；也可通过 ALLOWED_HOSTS 提供额外主机。ALLOWED_ORIGINS 是权威的精确来源覆盖项（包括方案、主机名和有效端口），而具体的旧版 ALLOWED_ORIGIN 则保留此前的单一精确来源限制。不支持通配符 Origin 验证；历史配置 ALLOWED_ORIGIN=* 会回退到安全的内置允许列表。

官方 MCP Registry

注册的服务标识为：

io.github.Steven3265/homechecker-guides

发布流程通过以下方式自动执行：

GitHub → Actions → Publish to MCP Registry → Run workflow

此工作流会安装依赖项、运行发布检查、使用 GitHub OIDC 进行身份验证、发布当前的 server.json 元数据，并验证官方 Registry 能否解析 Homechecker 服务。

发布版本通过固定的 GitHub OIDC 发布工作流发布到官方 MCP Registry。

更新指南快照

MCP 不会在运行时获取实时网站内容，而是提供从公开导出数据重新构建的打包快照。

Homechecker 门户仍是编辑内容的唯一可信来源：在那里发布或编辑指南，部署后导出内容会自动更新。

通过浏览器操作：

1. Actions → Refresh guides snapshot → Run workflow。
2. 工作流会获取 https://homechecker.com.au/guides/export.json。
3. 它会重建 data/guides.json，并运行验证器、核心测试和检索基准测试。
4. 如果内容发生变化，它会创建一个拉取请求。
5. 合并拉取请求后，Vercel 会重新部署。

如果唯一的变化只是时间戳，快照将保持不变，也不会创建拉取请求。

一次性仓库设置：

Settings → Actions → General → Allow GitHub Actions to create and approve pull requests

也可选择在终端中操作：

npm run snapshot
npm run snapshot -- --url <export-url>
npm test
npm run benchmark

验证

npm run validate:snapshot
npm run test:core
npm run benchmark
npm run check

检索评估包含 199 个案例，涵盖所有已发布的 spoke、多州信息保留、司法管辖区隔离、法规标题与 ACT 歧义、时代置信度回归、弱背景问题、正确的空结果处理，以及包含 85 个查询的开放世界碰撞测试套件。当前校准基线为：Top-1 召回率 91.1%、Top-3 召回率 100%、弱背景处理率 100%、正确空结果处理率 100%、开放世界安全性 100%、强相关误判为负的数量为零（0/109），司法管辖区信息泄漏为零（0/13 次泄漏探测）。

这是内部检索基准测试，并非对法律或技术准确性的独立评估。

发布验证还会检查机器分发元数据，并确保派生的 Skill 副本与规范的 skills/ 源保持一致。

仓库结构

api/
  index.ts                 service metadata
  mcp.ts                   Streamable HTTP MCP endpoint
  health.ts                health and snapshot status
  mcp-server-card.ts       experimental MCP Server Card (identity + remote connection)
  server-card.ts           extended Homechecker service metadata
  openapi.ts               OpenAPI 3.1 description
  v1/                      read-only REST adapters

src/
  identity.ts              canonical server/protocol identity
  core.ts                  deterministic search and checklist logic
  server.ts                MCP tools, resources and operational telemetry
  http-handler.ts          REST adapter over the deterministic core
  http-json.ts             shared HTTP/CORS/attribution helpers
  stdio.ts                 local stdio entry

skills/                    canonical portable Agent Skills
public/skills/             public synchronised Skill copies
distribution/
  openai/homechecker/      OpenAI Skills/plugin submission package
  github-agentfinder/      GitHub Agent Finder contribution records

.claude-plugin/            Claude plugin metadata
.github/plugin/            GitHub/Copilot plugin metadata
.github/workflows/         validation, refresh and Registry publication
plugin.json                Agent Plugins package manifest
mcp.json                   Agent Plugins MCP dependency
.mcp.json                  Claude-compatible MCP configuration

data/guides.json           bundled canonical guide snapshot
data/TERMS.md              editorial corpus terms
data/benchmark.json        retrieval benchmark cases

scripts/                   snapshot, Skill sync, validation and benchmarks
docs/                      architecture, protocol, security and release notes
public/.well-known/        machine-readable security contact
vercel.json                production routing

内容与许可

软件和配置代码采用 MIT 许可证，详见 LICENSE.md。

Homechecker 编辑内容库（包括 data/guides.json 和本仓库其他位置转载的指南材料）仍归 Steven McCormack（以 Moyne Ross 名义经营）所有，版权 © Steven McCormack，并单独受 data/TERMS.md 约束。

在注明出处并链接至规范指南的情况下，可引用合理篇幅的内容。

“Homechecker”和“Moyne Ross”是 Steven McCormack（ABN 18 890 160 412）使用的商业名称。

关于出版方

Homechecker 是由 Steven McCormack（ABN 18 890 160 412）以 Moyne Ross 名义经营的住宅指导与评估服务。

Homechecker · 指南库 · AI 与连接器 · Moyne Ross