Homechecker Guides

Homechecker Guides MCP

Homecheckerがオーストラリアの住宅購入者向けに専門的に執筆したガイドを、Model Context Protocolおよび相互補完する機械可読インターフェースを通じて提供します。接続されたアシスタントは、検査、契約、ストラータ、建築年代、情報開示、メンテナンスに関するコーパスを検索し、標準ガイドを取得して、出典を明記した購入者向けチェックリストを作成できます。全体を通してhomechecker.com.auを引用します。

公開、読み取り専用であり、顧客向けシステムや査定システムとは意図的に分離されています。

このサービスは、Moyne Rossポータル、Supabase、顧客記録、決済、アップロードされたドキュメント、Homechecker査定エンジンには接続せず、現行の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サーバーカード（実験的拡張機能）： 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 Guidesは、新興のMCPエコシステム全体で独立してインデックス化されています。これらのサードパーティ掲載情報は、それぞれのペースで更新される場合があります。

• Smithery
• Glama
• LobeHub
• M8ven

正式なサーバーIDは引き続き公式MCP Registryの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 が MCP ルーティングヘッダーを JSON-RPC リクエストと照合して検証し、不一致を拒否します。ベアの 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 リソース： 機械可読なカタログ 1 件、ガイドハブ、公開済みガイド 33 件です。
• 4 つの読み取り専用 MCP ツール： カタログ一覧表示、自然言語検索、正規ガイドの取得、決定論的な購入者向けチェックリストです。
• 読み取り専用 HTTP アダプター： 同じ決定論的な一覧表示、検索、取得、チェックリスト機能を提供する REST エンドポイントです。
• OpenAPI 3.1： MCP を話さないクライアント向けに、REST のインターフェースを機械可読な形式で記述しています。
• 2 つのディスカバリードキュメント： /mcp/server-card にある標準化プロセス進行中の実験的 MCP Server Card には、識別情報とリモート接続の詳細のみが含まれます。/server-card.json には、互換性と診断のため、より詳細な Homechecker サービスメタデータが保持されています。
• 4 つのエージェントスキル： オーストラリアの住宅購入者向けデューデリジェンス、不動産関連書類、建物リスクの解釈、住宅所有計画のための、持ち運び可能なワークフローです。
• 2 つの MCP トランスポート： ステートレスなリモート Streamable HTTP（/mcp）と、モダン／レガシー互換のローカル 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 適合性のチェックに加え、85 件のオープンワールド衝突テストスイートを含む 199 件の検索ケースがあります。

ツール

list_guides

公開済みガイドのメタデータを一覧表示します。

管轄区域、クラスター、物件タイプ、建築年代、購入段階で絞り込めます。

search_guides

住宅購入者からの自然言語の質問をもとに、コーパスを検索します。

ランキングされたガイド、関連セクション、正規 URL、レビューのメタデータ、制限事項を返します。建物検査費用に関する質問では建物・害虫検査の費用が見つかる場合があり、建物の動きに関する質問では構造上のひび割れと表面的なひび割れのガイドが見つかる場合があります。

get_guide

スラッグを指定してガイドを取得します。要約、選択したセクション、または正規 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

エージェントスキル

正式なポータブルスキルは skills/ にあります。

オーストラリアの住宅購入者向けデューデリジェンス

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

オファー、オークション、または契約が拘束力を持つ前に、住宅不動産のデューデリジェンスを体系化します。

オーストラリアの不動産関連書類

skills/australian-property-documents/SKILL.md

管轄区域に応じたワークフローを提供し、売却時の開示情報、契約書、ストラタまたは所有者法人の資料を理解するのに役立ちます。

オーストラリアの住宅建築リスクの読み解き

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

物件を遠隔で診断することなく、築年、建築方法、症状に基づいて、オーストラリアの住宅建築に共通するリスクを慎重に判断できるようエージェントを支援します。

オーストラリアの住宅所有計画

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

Homechecker のガイダンスを活用して、メンテナンス、記録、改修の準備、所有計画を整理します。

skills/ が正式なソースです。公開用および OpenAI 配布用のコピーはこれらのファイルから同期され、リリース検証ではコピーの差異があると失敗します。

ディスカバリー

Homechecker 独自の Agentic Resource Discovery カタログは、以下で公開されています。

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

このカタログでは、ドメインに基づく識別子と代表的な自然言語クエリを使って、Homechecker MCP と4つのエージェントスキルについて説明しています。

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. リモート MCP エンドポイントとして https://mcp.homechecker.com.au/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

登録済みサーバーの ID は次のとおりです。

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

検索評価には、公開済みのすべてのスポーク、複数の州にまたがる記録保持、管轄区域の分離、法律名と ACT の曖昧さ、時代に関する確信度のリグレッション、情報が少ない質問や背景情報に関する質問、正しく空の結果となる範囲外の質問、85 件のクエリからなるオープンワールドの衝突テストスイートを対象とした 199 件のケースが含まれます。現在の調整ベースラインは、top-1 再現率 91.1%、top-3 再現率 100%、情報が少ない質問や背景情報に関する質問への対応率 100%、正しく空の結果となる質問への対応率 100%、オープンワールド安全性 100%、強い誤判定が 0 件（0/109）、管轄区域の混入が 0 件（混入を調べるプローブ 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

コンテンツとライセンス

ソフトウェアと設定コードは、LICENSE.md に基づき MIT ライセンスで提供されています。

data/guides.json や、このリポジトリ内の他の場所に転載されているガイド資料を含む Homechecker の編集コーパスは、引き続き © Steven McCormack（Moyne Ross の商号で事業を運営）に帰属し、data/TERMS.md に基づき、別途管理されています。

出典を明記し、正規のガイドへのリンクを添えれば、妥当な範囲で引用できます。

「Homechecker」と「Moyne Ross」は、Steven McCormack（ABN 18 890 160 412）が使用する商号です。

発行者について

Homechecker は、Moyne Ross の商号で事業を運営する Steven McCormack（ABN 18 890 160 412）が提供する、住宅に関するガイダンスおよび評価サービスです。

Homechecker · ガイドライブラリ · AI とコネクター · Moyne Ross