AI HomeDesign MCP

AI HomeDesign MCP Server — Claude 向け AI バーチャルステージング、ホームステージング、インテリアデザイン

AI バーチャルステージングと不動産写真の編集に対応した、オープンソースの Model Context Protocol（MCP）サーバーです。 AI HomeDesign の写真 API を自然言語で操作できるツールに変換するため、Claude やその他の MCP クライアントは、依頼するだけでバーチャルホームステージング、AI インテリアデザイン、写真の補正、不要な物の除去、昼から夕暮れへの変換を実行できます。

---

これは何ですか？

AI HomeDesign MCP Server は、AI HomeDesign V3 API を Model Context Protocol のツールとして、ストリーミング可能な HTTP 経由で提供します。MCP に対応する AI クライアントなら、Claude Desktop、ブラウザー版 Claude、Cursor などから、自然な英語でプロ向けの不動産写真編集を実行できます。

• 🛋️ バーチャルステージング — 空室に、選んだデザインスタイルのフォトリアルな AI 家具を配置します。家具を実際に用意することなく、数秒でデジタルのホームステージングができます。
• 🎨 バーチャル再ステージングと AI インテリアデザイン — 既存の家具を入れ替えたり、家具が配置された部屋を全面的にデザインし直したりできます。
• ✨ 画像補正 — 照明、鮮明さ、色のバランスを調整し、物件掲載に適した写真に仕上げます。
• 🧹 アイテムの除去／整理 — 家具や散らかった物を自動で除去し、すっきりした空間を映し出します。
• 🌆 昼から夕暮れへ — 昼間の外観写真を、温かみのある薄暮や夕暮れのシーンに変換します。
• 🧱 壁、床、天井の変更 — センスのよい AI 仕上げで表面のスタイルを変えます。

MCP に対応しているため、習得が必要な SDK はありません。希望する内容を説明すれば、モデルが適切なパラメーターで対応するツールを呼び出します。

MCP によるバーチャルステージングとホームステージングの利点

従来のホームステージングでは、家具をレンタルして撮影を手配する必要があります。不動産業者向けのバーチャルステージングなら、編集済みの写真でそれを代替できますが、編集ツールで何時間も作業したり、ステージングサービスの納品に何日も待ったりする必要は依然としてあります。

このサーバーなら、その一連の作業を会話の中で完結できます。物件の写真をアップロードし、スタイルを選ぶだけで、ダウンロード可能な販売準備済みの画像が返されます。マルチテナント（呼び出し元ごとに各自の AI HomeDesign キーを使用）、ステートレス、セルフホスト可能なため、個人のエージェントにも、本番環境の PropTech 製品にも適しています。

---

利用可能なツール

ツール	機能	入力
list_capabilities	ツールをカテゴリ別に一覧表示	—
list_styles	利用可能なデザインスタイル、部屋の種類、ウィジェットのオプションを一覧表示	—
describe_tool	ツールの入力と、そのまま使えるリクエスト例を表示	ツールのスラッグ
virtual_staging	空の部屋にデザインスタイルに合わせた家具を配置	画像 + スタイル + 部屋
virtual_restaging	すでに家具がある部屋の家具を入れ替え	画像 + スタイル + 部屋
interior_design	家具が配置された部屋を全面的にデザインし直す	画像 + スタイル + 部屋
enhance_image	照明、鮮明さ、色を改善	画像
remove_items	散らかった物や家具を除去	画像
day_to_dusk	昼間の外観を夕暮れに変換	画像
change_wall / change_floor / change_ceiling	表面のスタイルを変更	画像 + 部屋
create_project · create_order · run_process · get_process · wait_for_result	細かく制御するための低レベルのプリミティブ	describe_tool を参照

各ヘルパーは画像 URLまたはbase64 画像を受け取り、ダウンロード可能な結果画像の URL を返します。

対応するデザインスタイル： prime、modern、farmhouse、scandinavian、 hampton、industrial、traditional、contemporary。 対応する部屋の種類： 寝室、リビングルーム、キッチン、バスルーム、ダイニングルーム、 ホームオフィス、屋外、子ども部屋。

---

クイックスタート

オプション A — ホスト型サーバーに接続する（セットアップ不要）

1. API キーを取得します。 aihomedesign.com にサインインし、 API / Developer settings を開いて、x-api-key をコピーします。

2. コネクターリンクを生成します。 そのキーをジェネレーター aihomedesign.com/mcp に貼り付けます。キーは サーバー側で一度検証された後、暗号化して保存されます。個人用のエンドポイントが発行されます。

   https://mcp.aihomedesign.com/aihd_<your-token>/mcp
   

   URL に生のキーが含まれることはありません。

3. AI アシスタントに追加します。 Claude では、Settings → Connectors → Add custom connector を選択し、名前を AI HomeDesign にして、URL を貼り付けます。すべてのツールが 自動的に表示されます。MCP 互換クライアントならどれでも利用できます。

⚠️ コネクターリンクに生のキーは含まれませんが、アカウントへのアクセス権が付与されます。パスワードと同様に取り扱ってください。 AI HomeDesign ダッシュボードでキーをローテーションすると、そのキーに対して以前に発行されたすべてのリンクが無効になります。

サーバーのヘルスチェック（キー不要）：mcp.aihomedesign.com/health

オプション B — Docker でセルフホストする

git clone https://github.com/AIHomeDesign/aihomedesign-mcp.git
cd aihomedesign-mcp
cp .env.example .env      # add your AIHD_API_KEY (and DB_DSN/TOKEN_SECRET for multi-tenant)

docker build -t aihomedesign-mcp .
docker run -p 8080:8080 --env-file .env aihomedesign-mcp

MCP エンドポイントは http://localhost:8080/mcp（ストリーミング可能な HTTP）で提供されます。ヘルスチェックは GET /health です。

オプション C — Python でローカル実行する

pip install -r requirements.txt
export AIHD_API_KEY=your_key_here
python app/server.py

---

設定

設定はすべて環境変数で行います。 .env.example を参照してください。

変数	用途	デフォルト
AIHD_API_KEY	デフォルト／フォールバック用の AI HomeDesign x‑api‑key	—
AIHD_API_BASE	API ベース URL	https://api.aihomedesign.com/v3
PORT	リッスンポート	8080
DB_DSN	トークンマップおよび使用ログ用の Postgres DSN（任意）	—
TOKEN_SECRET	保存時のユーザーキー暗号化に使う Fernet キー（任意）	—
MCP_CONNECTOR_BASE	コネクターリンクの生成に使うベース URL	—
UPLOAD_DIR / PUBLIC_BASE	組み込みの画像アップロードエンドポイントを有効化	—

セキュリティとマルチテナント設計

• 独自のキーを使用： 各リクエストには呼び出し元自身の AI HomeDesign キーが含まれ、そのキーでジョブが実行されます。
• キーが URL に含まれることはありません： ランディングページでキーを検証した後、不透明な aihd_… コネクタートークンを発行します。生のキーは保存時に暗号化（Fernet）され、 リクエストごとに元のキーに戻されます。
• 使用ログには呼び出しごとのツール、ステータス、所要時間が記録されます。生のキーは記録されず、 短い不可逆のフィンガープリントのみが記録されます。
• 段階的な機能低下： データベースに接続できない場合も、サーバーは処理を続けます。

---

仕組み

MCP client (Claude, Cursor, …)
        │  streamable HTTP  /mcp
        ▼
AI HomeDesign MCP server  ──►  AI HomeDesign V3 API  ──►  result image URLs
   (this repo)                  (api.aihomedesign.com)

サーバーは FastMCP と Starlette/uvicorn を基盤とし、 リクエストごとのキーを紐付ける純粋な ASGI 認証ミドルウェアを備えています。

技術スタック

Python 3.12 · MCP（FastMCP）· Starlette · uvicorn · httpx · PostgreSQL（任意）· Docker。

よくある質問

MCP サーバーとは何ですか？

MCP サーバーは、Anthropic が策定したオープン標準である Model Context Protocol を通じて、AI モデルにツール、データ、プロンプトを公開します。モデルは実行時に利用可能なツールを見つけ、自ら呼び出すため、独自の SDK に合わせた接着コードを書く必要はありません。このリポジトリは、不動産写真を編集するツールを備えた MCP サーバーです。

これを使って写真をバーチャルステージングするには？

サーバーを Claude に接続し、何もない部屋の写真を送って、スタイルを指定します。たとえば 「このリビングルームを北欧風にスタイリングして」 と依頼します。Claude は適切なパラメーターで virtual_staging ツールを呼び出し、ダウンロード可能なフォトリアル画像を返します。手動編集もデザインソフトも必要ありません。

この AI バーチャルステージングは無料ですか？

MCP サーバー自体はオープンソースで、MIT ライセンスのため、無料でセルフホストできます。画像処理には AI HomeDesign API を使用し、ご自身の API キーが必要です。

Claude 以外のクライアントでも動作しますか？

はい。ストリーミング可能な HTTP 経由で標準の MCP を使用するため、Claude Desktop、ブラウザー版 Claude、Cursor など、MCP 互換クライアントならどれでも利用できます。

バーチャルステージングとバーチャル再ステージングの違いは何ですか？

バーチャルステージングでは、家具のない部屋に家具を配置します。バーチャル再ステージングでは、すでに家具が置かれている部屋の家具を入れ替えます。家具を入れ替えるだけでなく、家具のある部屋を全面的にデザインし直したい場合は、interior_designを使用してください。

---

詳細はこちら

• 🔌 ワンクリックで接続：aihomedesign.com/mcp
• 🌐 ウェブサイト：aihomedesign.com
• 📖 Model Context Protocol：modelcontextprotocol.io

コントリビューション

イシューやプルリクエストを歓迎します。大きな変更については、まずイシューを作成してご相談ください。

ライセンス

MIT Licenseのもとで公開されています。

---

_{キーワード：MCP サーバー · Model Context Protocol · Claude MCP · Anthropic MCP · MCP ツール · バーチャルステージング · AI バーチャルステージング · バーチャルステージングソフトウェア · ホームステージング · 不動産業者向けバーチャルステージング · AI ホームデザイン · AI インテリアデザイン · 不動産写真 · 不動産写真編集 · バーチャル再ステージング · 昼から夕暮れへの変換 · 画像補正 · アイテム削除 · 不動産 AI · PropTech。}