real-estate-brokerage-act-mcp

不動産取引実務に必要な法令・通達を e-Gov 法令 API からリアルタイム取得する MCP サーバー。

AI の不動産法規回答に含まれるハルシネーションを、条文原文との照合によって防ぐ。

特徴

• 法令取得 — e-Gov 法令 API v2 から条文を Markdown 形式で取得
• 法令検索 — キーワードで法令を横断検索
• 通達・告示取得 — 報酬額告示・原状回復 GL・事故物件 GL・IT 重説マニュアル等 10 件の実務頻出資料を国交省 PDF から取得
• 検索ファースト — e-Gov API 検索による動的な法令解決。プリセットに限らず、e-Gov 収録の全法令を取得可能
• 略称マップ — 宅建業法・都市計画法・建築基準法・所得税法ほか 85 法令の略称を登録済み。施行令第 3 条（重説・法令上の制限）の全 48 法令 + 税法 6 法令 + 暴対法・個人情報保護法等を含む
• キャッシュ — 検索 30 分・法令データ 24 時間の TTL キャッシュ
• API 耐障害性 — 自動リトライ（exponential backoff）+ サーキットブレーカー
• 運用可視化 — 構造化 JSON ログ + 使用量メトリクス（get_metrics ツール）+ セキュリティ監査ログ

Web で使う（Vercel デプロイ）

Vercel にデプロイすると、Claude.ai からすぐに使えます。環境変数の設定は不要です（e-Gov API は公開 API）。

Claude.ai でのセットアップ（Free/Pro/Max/Team/Enterprise）

注意: Custom Connectors はベータ版のため、接続が不安定な場合があります。安定してご利用いただくには npx（ローカル）でのセットアップもご検討ください。

1. 上の「Deploy with Vercel」ボタンでデプロイ（ワンクリック）
2. claude.ai → プロフィールアイコン → Settings → Connectors
3. 「Add custom connector」をクリック
4. URL に https://your-app.vercel.app/api/mcp（your-app をデプロイ先に置換）を入力
5. チャットで「+」→「Connectors」→ real-estate-brokerage-act を有効化
6. 「宅建業法第35条を教えて」と質問

参考: Get started with custom connectors using remote MCP

Vercel Free tier の制限事項

• 関数の実行時間が 10 秒 に制限されます（Pro プランでは 60 秒）
• get_tsutatsu（通達取得）は PDF ダウンロード + パースが重いため、タイムアウトする場合があります
• BUILDING_LAW_REQUEST_TIMEOUT=8000 を設定してタイムアウトを短縮できます

---

ローカルで使う（stdio）

npx（推奨）

インストール不要で実行できます。

npx -y real-estate-brokerage-act-mcp

Claude Desktop

claude_desktop_config.json に以下を追加してください。

{
  "mcpServers": {
    "real-estate-brokerage-act": {
      "command": "npx",
      "args": ["-y", "real-estate-brokerage-act-mcp"]
    }
  }
}

Claude Code

claude mcp add real-estate-brokerage-act -- npx -y real-estate-brokerage-act-mcp

Windows + VS Code 拡張機能の場合

VS Code 拡張機能では npx 経由の起動が Connection closed エラーになる場合があります。 プロジェクトルートに .mcp.json を作成してください。

Step 1: グローバルインストール

npm install -g real-estate-brokerage-act-mcp

Step 2: パスの確認

where node        # → node.exe のフルパス（例: C:\Program Files\nodejs\node.exe）
npm root -g       # → グローバル node_modules のパス

Step 3: .mcp.json を作成

取得したパスで置き換えてください（パス区切りは / を使用）:

{
  "mcpServers": {
    "real-estate-brokerage-act": {
      "command": "<where node の出力>",
      "args": [
        "<npm root -g の出力>/real-estate-brokerage-act-mcp/dist/index.js"
      ]
    }
  }
}

注意: .mcp.json にはマシン固有のパスが含まれるため、.gitignore に追加してください。

ローカル（ソースから）

git clone https://github.com/Sora-bluesky/real-estate-brokerage-act-mcp.git
cd real-estate-brokerage-act-mcp
npm install
npm run build

{
  "mcpServers": {
    "real-estate-brokerage-act": {
      "command": "node",
      "args": ["/path/to/real-estate-brokerage-act-mcp/dist/index.js"]
    }
  }
}

MCP ツール

ツール	説明
get_law	条番号を指定して法令の条文を取得する。略称・正式名称のいずれでも指定可能
get_full_law	法令の全文を取得する
search_law	キーワードで不動産関連法令を横断検索する
get_tsutatsu	国交省の通達・ガイドライン・告示を取得する（報酬額告示、原状回復 GL 等）
check_law_updates	法令の改正状況を e-Gov API で確認する
get_laws_batch	複数の法令・条文を一括取得する（最大 20 件）
verify_citation	AI の回答に含まれる法令引用を検証する
suggest_related	指定した条文の関連法令・委任先を自動抽出して提案する
analyze_article	条文の構造解析メタデータを JSON 形式で返す
get_metrics	サーバーの使用量メトリクスを返す

パラメータ

get_law

パラメータ	説明	例
law_name	法令名（正式名称または略称）	宅建業法, 建築基準法
article_number	条文番号（附則・別表にも対応）	第35条, 附則, 別表第一
format	出力形式（text または structured、省略時は text）	structured

get_full_law

パラメータ	説明	例
law_name	法令名（正式名称または略称）	宅建業法施行令, 都市計画法

search_law

パラメータ	説明	例
keyword	検索キーワード	重要事項説明, 媒介報酬

get_tsutatsu

パラメータ	説明	例
tsutatsu_name	通達・ガイドライン名	報酬額告示, 事故物件ガイドライン

This is the beginning of the README. Read the rest at the original. Read the full README ↗