Japan Real Estate Intel MCP

Cross-analyze Japanese real estate data across 10 prefectures via MCP. Land prices, disaster risk, population, foot traffic, education, corporate presence, PLATEAU 3D buildings, renovation yield, and contract support — all accessible through Claude, ChatGPT, Cursor, or any MCP client.

Registry: io.github.sugukurukabe/japan-real-estate-intel-mcp · Growth / listings: docs/growth-playbook.md

Try in 60 seconds (Free tier — safe for demos)

Copy into Claude, Cursor, or ChatGPT after npx @sugukuru/japan-real-estate-intel-mcp:

discover_opportunities で愛知県の investment 向けエリアを探して。limit=5

More copy-paste prompts (3 demos, no Pro tools): docs/free-demo-prompts.md
Map only: Dashboard (Aichi)

Do not demo PDF reports, Linear numeric sim, or contract tools on the default Free plan — they require Pro. See tiers and pro-demo-setup.md.

Data freshness & trust

Quick Install

Claude Desktop (stdio):

npx @sugukuru/japan-real-estate-intel-mcp

Claude Desktop (remote — no login/API key required):

{
  "mcpServers": {
    "japan-real-estate-intel": {
      "url": "https://realestate-mcp.jp/mcp"
    }
  }
}

https://realestate-mcp.jp is an authless public connector — no headers needed. X-Api-Key only applies if you self-host with API_KEY set (see docs/deploy.md); X-License-Key / _licenseKey unlocks Pro/Enterprise tiers on any instance (see pro-demo-setup.md) — the two are unrelated.

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "japan-real-estate-intel": {
      "command": "npx",
      "args": ["@sugukuru/japan-real-estate-intel-mcp"]
    }
  }
}

Key Features

• 38 tools covering market analysis, risk assessment, forecasts, renovation yield, contract support, zoning, vacancy, population outlook, macro snapshots, price triangulation arbitrage, portfolio optimization, demographic forecasting, and building code compliance audit

• 10 prefectures: Aichi, Tokyo, Osaka, Fukuoka, Hokkaido, Kanagawa, Kyoto, Hyogo, Saitama, Chiba

• 17+ data sources: land prices, 路線価 (rosenka), disaster hazards (earthquake + flood), population, zoning, vacancy, population projection, foot traffic, education, corporate, transport, commercial, medical, PLATEAU 3D

• Interactive dashboard with 2D map, 3D PLATEAU view, responsive PWA, and price triangulation panel

• Bilingual English + Japanese tool descriptions and UI

• MCP Apps UI for Claude Desktop and Cursor

• Tiered access (free / pro / enterprise)

Links: Dashboard | Privacy Policy | Terms | API Docs | Demo script

Author & community

日本語セクション (Japanese)

日本の不動産投資・仲介・開発・管理向けに、地価・取引価格・路線価・人口統計・災害リスク・人流・教育環境・企業立地・交通・商業施設・医療福祉・3D 日照シミュレーション・町丁目実データ をクロス分析する MCP サーバー。

v8.0.0 — Claude公式ディレクトリ審査対応。OAuth撤去、認証不要（authless）の公開コネクタに単純化（Pro/Enterprise はECDSA署名ライセンスキーのみで解放）。getRequestTierの署名なしバイパス除去・/api/licenseのStripeセッションID化・/metrics鍵保護など各種セキュリティ修正。全38ツールにtitle・idempotentHintを付与。生成レポート/CSV/Excelをresource_link（HTTP: /artifacts/:id、stdio: artifact://）でダウンロード可能に。ダッシュボードのウィジェットカードにCSV/PNGエクスポートツールバーを追加。

v7.0.0 — MCP Apps 公式SDK(@modelcontextprotocol/ext-apps)へ移行。2D地図・3D PLATEAUビューア・ツール別ウィジェットを React + Vite の単一ダッシュボードに統合。

v6.15.4 — セキュリティ強化（秘密鍵除去・デモキー本番ガード・/metrics 認証保護）、Tier 設定補完、MCP 仕様準拠監査合格（4プリミティブ + MCP Apps + OAuth 2.1）、Glama 掲載。

v6.15.2 — Free プラン月間ツール上限（50回/月 UTC）、Glama 用 Dockerfile.glama、外部掲載手順更新。

v6.15.1 — 公式 MCP Registry 掲載（io.github.sugukurukabe/japan-real-estate-intel-mcp）。npm mcpName 整合。

v6.15.0 — 路線価（NTA）×公示地価×取引価格の三角測量で「割安物件・相続有利エリア・市場過熱」をスキャンする detect_arbitrage_signals を追加。総合価値スコアにアービトラージ補正を加味。あわせて県単位マクロを一枚にまとめる get_real_estate_macro_snapshot（地価YoY・取引件数・人口減、任意で e-Stat 建築着工・金利プロキシ）を追加。

v6.13.0 — 用途地域・空き家率・将来人口推計データを追加、総合価値スコア 5 軸融合、Opportunity Radar 強化、全 10 都道府県の災害リスクCSV完備。Anthropic MCP Registry / OpenAI Apps Directory 対応。

不動産業者の方へ

3 分で始められるガイドはこちら: 不動産業者向けクイックスタート

ダッシュボード: https://realestate-mcp.jp/dashboard.html

はじめての方へ — クイックスタート

ダッシュボード（ブラウザ）で試す

open_dashboard ツールでダッシュボードを開くと、初回起動時に「クイックスタート」ポップアップが自動表示されます。 6 つのサンプルシナリオをワンクリックで試せます。

次回から表示しない場合は「次回から表示しない」をクリック。 いつでも右パネルの「クイック事例を見る →」リンクで再表示できます。

Claude / Cursor チャットで試す

MCP Prompt quick_start_examples を呼び出すと、コピー＆ペーストできるサンプルコード（Free / Pro・Enterprise 別）を一覧表示します。

# Cursor または Claude でプロンプトを呼び出す
quick_start_examples

または、ライセンスキー不要で今すぐ動く Free tier の例をそのままチャットに貼り付けて実行:

# 1. Opportunity Radar（次に見るべきエリア発見）
discover_opportunities({ "prefecture": "愛知県", "goal": "investment", "horizon": "3y", "limit": 5 })

# 2. 地価トレンド予測
forecast_land_price_trend({ "prefecture": "東京都", "city": "新宿区", "horizon": "5y" })

# 3. 価格の歪み検出（路線価×公示地価×取引価格）
detect_arbitrage_signals({ "prefecture": "愛知県", "signalType": "discount" })

Pro/Enterprise限定（predict_corporate_demand / assess_family_friendly_score / portfolio_optimizer / scenario_what_if / evaluate_store_location 等）を試す場合は、_licenseKey 引数または X-License-Key ヘッダーにライセンスキーを渡してください。デモキーの入手方法は docs/pro-demo-setup.md を参照。

履歴メモ: v1.0（2025年11月、愛知県6ツール）から段階的に全国展開・機能拡張してきました。詳細な変遷は docs/implementation-story.md（v6.15.0時点のスナップショット）と CHANGELOG.md を参照してください。現行（v8.0.0）の正は文書冒頭（Key Features）、server.json の tools、pnpm test の結果です。10都道府県すべてが地価・災害リスク・人口・町丁目データを含む主要機能に対応しています。データソース別の詳細な対応可否は src/data-loaders/ 各ローダーの capabilities フィールドを参照してください。

特徴

• 38 ツール: 市場クロス分析 / リスク / ファミリー / 法人需要 / レポート / ダッシュボード / 都道府県比較 / ドリルダウン / 出店 / 日照シミュ / 予測・What-If / PF 最適化 / リノベ・契約・用途地域・空き家率・人口推計・マクロ・アービトラージ / 人口動態予測 / 建築基準適合監査 等（詳細は冒頭 Key Features）

• 12 レイヤーダッシュボード + 3D ビューア: 地価 / 災害リスク / 取引 / 人口 / 人流 / 学区 / 企業密度 / 3D 建物 / 交通 / 商業施設 / 医療 / 影 + Three.js 3D ビューア

• 10 都道府県対応: 愛知県（フル機能・名古屋市町丁目データ）/ 東京都・大阪府・福岡県・北海道・神奈川県・京都府・兵庫県・埼玉県・千葉県（標準対応）

• 町丁目実データ: 名古屋市を中心に、町丁目レベルの人口・世帯・計画データ等（対象エリアはデータソースに依存）

• 都道府県セレクタ: ダッシュボード上で 10 都道府県を切り替え、比較モードで任意の 2 エリアを並列表示

• 比較モード（v2.1 フル機能）: 地図 2 分割 + SVG レーダーチャート + ランキングテーブル + bestFor 表示

• ドリルダウンパネル（v2.1 new）: 市区町村クリックで詳細パネル展開。町丁目ラベル入力対応

• stdio + Streamable HTTP: 両トランスポート対応

• TypeScript strict + Zod: 型安全な入出力スキーマ

• プラガブル: BaseLoader を継承して新県を追加

クイックスタート

git clone https://github.com/sugukurukabe/japan-real-estate-intel-mcp.git

cd japan-real-estate-intel-mcp

pnpm install

pnpm build

stdio（ローカル）

node dist/index.js

Streamable HTTP（リモート）

node dist/http.js

# → http://0.0.0.0:3100/mcp

クライアント設定

Claude Desktop

{

  "mcpServers": {

    "japan-real-estate-intel": {

      "command": "node",

      "args": ["dist/index.js"],

      "cwd": "/path/to/japan-real-estate-intel-mcp"

    }

  }

}

Cursor (.cursor/mcp.json)

{

  "mcpServers": {

    "japan-real-estate-intel": {

      "command": "node",

      "args": ["dist/index.js"],

      "cwd": "/path/to/japan-real-estate-intel-mcp"

    }

  }

}

ツール一覧（参考: v2.3 時点の 10 本）

現行は 38 ツールです。完全な一覧はリポジトリ直下の server.json の tools 配列、または pnpm test が通る tests/server_json_tools_sync.test.ts を参照してください。

cross_analyze_real_estate_market

都道府県内エリアの不動産市場をクロス分析。includeHumanFlow / includeEducation / includeCorporate / includeTransport / includeCommercial / includeMedical フラグで付加情報をオプトイン。

| パラメータ | 型 | デフォルト | 説明 |

|---|---|---|---|

| prefecture | string | "愛知県" | 都道府県名 |

| area | string | - | エリア名 |

| propertyType | enum | - | residential / commercial / logistics / office / mixed |

| timeRange | enum | - | 1y / 3y / 5y |

| includeRisk | boolean | true | 災害リスクを含むか |

| includeHumanFlow | boolean | true | 人流データを含むか |

| includeEducation | boolean | false | 教育データを含むか |

| includeCorporate | boolean | false | 企業データを含むか |

| includeTransport | boolean | false | 交通利便性データを含むか (v2.2) |

| includeCommercial | boolean | false | 商業施設データを含むか (v2.2) |

| includeMedical | boolean | false | 医療施設データを含むか (v2.2) |

ローダーがデータセットを提供しない場合、該当フィールドは undefined になり、keyInsights 等に 「当該都道府県では未提供」 の旨が表示されます。

assess_property_risk

特定住所の浸水・土砂・地震リスクを評価し、リスクスコアと価格調整率を算出。

assess_family_friendly_score

学区・教育環境・犯罪統計を加味したファミリー物件評価。子育て世帯向け資産価値を算出。

predict_corporate_demand

企業立地・事業所統計・通勤データで法人需要を予測。

generate_area_report

投資/開発/賃貸/管理レポートを Markdown 形式で生成。

open_dashboard

12 レイヤーの不動産ダッシュボードを起動。比較モード（地図 2 分割 + SVG レーダー）、ドリルダウンパネル、影シミュレーション（時刻プリセット）を搭載。

compare_prefectures (v2.1 新設)

2〜5 都道府県を複数メトリクスで比較分析。レーダーチャート・ランキング・差分ハイライト・bestFor を返す。

| パラメータ | 型 | デフォルト | 説明 |

|---|---|---|---|

| prefectures | string[] (2-5) | - | 比較対象都道府県名リスト |

| area | string | optional | 代表エリア（省略時: 愛知→名古屋市中区、東京→千代田区） |

| neighborhood | string | optional | 町丁目ラベル（v2.1 はレポートへの反映のみ） |

| propertyType | enum | "mixed" | residential / commercial / logistics / office / mixed |

| metrics | enum[] | ["price","risk","investment"] | 比較指標（price/risk/humanFlow/education/corporate/investment/transport/commercial/medical） |

| includeMarkdown | boolean | true | Markdown レポートを含むか |

出力: scores[]（各都道府県スコア）, ranking[], radarData[]（SVG 用正規化値）, diffs[]（差分ハイライト）, bestFor（投資/安全/成長別おすすめ）, markdownReport

drill_down_local_analysis (v2.1 新設)

市区町村・町丁目レベルのドリルダウン分析。ローカル不動産屋向けセールスピッチと Markdown レポートを生成。

| パラメータ | 型 | デフォルト | 説明 |

|---|---|---|---|

| prefecture | string | "愛知県" | 都道府県名 |

| city | string | - | 市区町村名（例: "名古屋市中村区"） |

| neighborhood | string | optional | 町丁目（例: "名駅南1丁目"）。v2.1 はラベルのみ |

| focus | enum | "all" | price / risk / demand / all |

出力: pricePerSqm, population, riskScore, floodLevel, humanFlowScore, transportScore, commercialDensity, medicalDensity, competitorDensity, localPitch（セールスピッチ文）, keyInsights[], markdownReport, households?, avgAge?, childRatio?, elderlyRatio?, daytimePopRatio?, popDensity?, neighborhoodDataAvailable?

v2.4 新機能: neighborhood 指定時に町丁目実データ（人口・世帯・年齢構成・昼夜間人口比）を返却します。データが無い場合は市区町村レベルの推定値を使用します。

evaluate_store_location (v2.2 新設)

コンビニ・ファミレス・カフェ・ドラッグストア・スーパーの出店適地評価。店舗タイプ別に重み付けを自動調整し、人口・人流・リスク・競合・交通・教育・商業施設・医療の 8 軸でスコアリング。

| パラメータ | 型 | デフォルト | 説明 |

|---|---|---|---|

| prefecture | string | "愛知県" | 都道府県名 |

| city | string | - | 市区町村名 |

| neighborhood | string | optional | 町丁目ラベル |

| storeType | enum | - | convenience / family_restaurant / cafe / drugstore / supermarket |

| radiusM | number | 500 | 競合・施設検索半径（m） |

| customWeights | Record | optional | カスタム重み付け（省略時はタイプ別デフォルト） |

| includeMarkdown | boolean | true | Markdown レポートを含むか |

出力: overallScore (0-100), breakdown（8 軸スコア）, keyCompetitors[]（距離・チェーン名・強度・弱点）, differentiationSuggestions[]（AI 差別化提案）, keyInsights[], markdownReport

simulate_landscape_impact (v2.3 新設)

SunCalc 太陽位置計算 + PLATEAU 3D 建物データから指定地点の日照・影をシミュレーション。影ポリゴン（[lat,lng][] 配列）を返すため、ダッシュボードや GIS に直接描画可能。

| パラメータ | 型 | デフォルト | 説明 |

|---|---|---|---|

| prefecture | string | "愛知県" | 都道府県名 |

| lat | number | - | 対象地点の緯度 |

| lng | number | - | 対象地点の経度 |

| dateTime | string | 現在時刻 | シミュレーション日時（ISO 8601） |

| timePreset | enum | optional | morning(8:00) / noon(12:00) / evening(17:00) |

| radiusM | number | 500 | 建物検索半径（m） |

| includeMarkdown | boolean | true | Markdown レポートを含むか |

出力: sunPosition（方位角・高度）, nearbyBuildingCount, maxHeight, avgHeight, totalShadowAreaSqm, sunlightHoursEstimate, shadowPolygons[]（建物名・高さ・影長・ポリゴン座標）, highImpactBuildings[], keyInsights[], markdownReport

Resources（現行 URI パターン）

| URI | 説明 |

|---|---|

| realestate://land-price/{prefecture}/{area} | 地価公示データ |

| hazard://flood/{prefecture}/{area} | 浸水想定区域 GeoJSON |

| stats://population-trend/{prefecture}/{area} | 人口統計 |

| ui://japan-real-estate-intel/dashboard | ダッシュボード HTML（MCP Apps） |

| artifact://{id} | generate_area_report 等が生成したPDF/Excel/CSV/Markdownのダウンロード（stdio）。HTTPトランスポートでは代わりに resource_link として GET /artifacts/:id/:filename を返す |

例: realestate://land-price/aichi/名古屋市中区, realestate://land-price/tokyo/世田谷区

都道府県の追加手順

新しい県を追加する場合:

1. data/<key>/ に最低限のファイルを配置:

   • land_price.csv, population.csv, flood.geojson, earthquake.json, municipalities.topojson

2. src/data-loaders/<key>-loader.ts を作成（BaseLoader を継承、capabilities を宣言）

3. src/data-loaders/index.ts で registerLoader(new XxxLoader()) を 1 行追加

4. src/prefecture/resolver.ts の PREFECTURE_KEYS にエイリアスを追加

それだけで prefecture: "大阪府" が全ツールで動作します。

データ出典

| データ | 出典 | 取得日 |

|---|---|---|

| 地価公示 | 国土交通省 | 2025-12-01 |

| 不動産取引価格 | 国土交通省 | 2025-12-01 |

| 浸水・土砂災害 | 国土交通省ハザードマップ | 2025-12-01 |

| 地震想定 | 内閣府 | 2025-12-01 |

| 人口統計 | 総務省 e-Stat | 2025-12-01 |

| 人流統計 | 国土交通省「全国うごき統計」| 2025-12-01 |

| 教育データ | 愛知県教育委員会 + e-Stat | 2025-12-01 |

| 事業所統計 | 総務省 e-Stat | 2025-12-01 |

| 犯罪統計 | 愛知県警察オープンデータ | 2025-12-01 |

| 3D都市モデル | 国土交通省 PLATEAU | 2025-12-01 |

| 交通利便性 | 国土交通省交通データ + JR/私鉄/市営地下鉄 | 2026-05-01 |

| 商業施設 | 商業統計 + チェーン店立地データ | 2026-05-01 |

| 医療福祉施設 | 厚労省オープンデータ | 2026-05-01 |

データについて: 各データは上記の取得日時点の本番データです。投資判断・契約判断には専門家へのご相談を併せてお願いします。

開発

pnpm install

pnpm dev          # TypeScript watch

pnpm build:ui     # ダッシュボード再ビルド

pnpm test         # Vitest (800+ tests, 59 files)

pnpm lint         # 型チェック

ロードマップ

v8.0.0（現バージョン）

• OAuth撤去 → authless公開コネクタ化（Pro/Enterprise は X-License-Key / _licenseKey のECDSA署名済みライセンスキーで解放）

• generate_area_report 等5ツールがPDF/Excel/CSV/Markdownを resource_link アーティファクトとしてダウンロード可能に

• ダッシュボードの各ウィジェットにCSV/PNGエクスポート機能を追加

• 全38ツールに title / outputSchema / 正確な idempotentHint 等のアノテーションを完備

• 10 都道府県 / 38 ツール（server.json と実行時で一致） / 800+ テスト（59 ファイル）

詳細は CHANGELOG.md と docs/releases/v8.0.0.md を参照。

ライセンス

AGPL-3.0-only（LICENSE 参照）