reel-estate-mcp

reel-estate-mcp

AI アシスタントから、不動産物件の掲載写真をシネマティックな物件紹介動画に変換できます。 reel-estate-mcp は、Claude、Cursor、その他の AI アシスタントをお使いのReel Estateアカウントに接続するModel Context Protocol（MCP）サーバーです。平易な言葉で指示するだけで、モーション動画の生成、写真の AI 編集（バーチャルステージング、夕景、季節の演出）、ナレーションの追加、物件紹介動画の完成まで行えます。

Reel Estate は、物件写真を思わずスクロールを止めて見入ってしまう物件紹介動画に変換する、AI 不動産動画プラットフォームです。無料アカウントは tryreelestate.com で作成できます。

ブラウザーから一度サインインするだけで利用できます（OAuth + PKCE — API キーやシークレットは不要です）。すべての呼び出しはバックエンドの /mcp エンドポイント経由でプロキシされ、認証、プラン、権限を一元的に管理します。このブリッジの特長は、さらにローカルの画像ファイルを読み込み、プロジェクトに直接ストリーミングできることです。完全なリモートサーバーでは実現できない機能です。

• 🎬 不動産動画の生成 — 写真に動きを付けて動画を生成し、ムービーをレンダリングします
• 🖼️ AI 写真編集 — バーチャルステージング、夕景、アップスケール、季節の演出、置換／削除／追加
• 🎙️ ナレーションとタイムライン — ナレーション、音楽、オーバーレイ、並べ替え
• 📤 ローカルからアップロード — ディスク上の写真をプロジェクトに取り込みます
• 🔐 ブラウザーでサインイン — パブリック OAuth クライアント + PKCE を使用し、シークレットは保存しません
• 🤖 対応クライアント — Claude Code、Claude Desktop、Cursor

必要条件

• Node.js 18 以降
• Reel Estate アカウント（作成／生成／レンダリングには有料プランが必要です。無料アカウントは MCP 経由での読み取り専用です）
• MCP 対応クライアント：Claude Code、Claude Desktop、または Cursor

インストール

クローンやビルドは不要です。MCP クライアントが必要に応じて npx 経由で起動します。必要なのは Node.js ≥ 18 だけです。（グローバルコマンドを使う場合は、npm install -g reel-estate-mcp を実行し、以下の npx -y reel-estate-mcp の代わりに reel-estate-mcp を使用してください。）

アシスタントを接続する

設定は不要です。ブリッジが Reel Estate に接続し、ブラウザーでのサインインも処理します。セットアップは必要ありません。

Claude Code

claude mcp add reel-estate -- npx -y reel-estate-mcp

Claude Desktop / Cursor

クライアントの MCP 設定（claude_desktop_config.json、~/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "reel-estate": {
      "command": "npx",
      "args": ["-y", "reel-estate-mcp"]
    }
  }
}

初回起動 — サインイン

最初のツール呼び出しでブラウザーが開き、Reel Estate アカウントへのサインイン画面が表示されます（Clerk OAuth、認可コード + PKCE）。承認すると、ブラウザーから http://localhost:8765/callback に戻り、トークンは ~/.reel-estate-mcp にキャッシュされます。これで利用を開始でき、トークンの有効期限が切れるまで再ログインは不要です。

まず whoami を使って認証を確認し、プランを確認してから、次のように依頼してください。

• 「最近のプロジェクトを一覧表示して。」
• 「123 Main St のプロジェクトを作成して、./listing 内の写真をアップロードして。」
• 「リビングの写真にバーチャルステージングを施して、ドローン動画を生成したら、9:16 でレンダリングして。」
• 「残りのクレジット数とエクスポート数を教えて。」

ユーザーを切り替える、または再認証するには、logout を実行します（サーバー側でトークンを無効化し、キャッシュを消去します）。または ~/.reel-estate-mcp を削除してください。

ツール

すべての API ツールはバックエンドの /mcp api_request を経由するため、バックエンド独自の認可ルールとプラン規則が適用されます。

ツール	機能
help	ガイド付きの最新ウォークスルー（getting_started プロンプトも兼ねます）
whoami	認証を確認し、plan、canWrite、書き込み可否の理由を示す writeAccess を報告します。最初に実行してください。
login / logout	ブラウザーでのサインインを開始／セッションを消去します（サーバー側での失効とローカルキャッシュの消去）
list_projects · get_project · project_stats	プロジェクトを参照します
list_clips · list_movies · list_voices	クリップ、レンダリング済みのムービー、TTS 音声を参照します
resolve_address	自由入力の住所をジオコーディングし、候補を順位付けして返します（実在物件のプロジェクト向け）
add_image_from_file	ローカル画像をプロジェクトにアップロードします（署名付きアップロード — ストレージの認証情報は不要）
ez_reel_add_photos · ez_reel_import_photos	ローカルの写真を 10〜20 枚 EZ Reel にアップロードする（署名付き）、またはプロジェクト内の既存の写真を再利用します
ez_reel_catalog	EZ Reel のテンプレートと楽曲
ez_reel_create · ez_reel_quote · ez_reel_submit · ez_reel_status	最短の手順： 写真、テンプレート、楽曲から完成した物件紹介リールを作成し、料金を見積もり、レンダリングし（費用の確認を求めます）、動画ができるまで状態を確認します
list_reels	EZ Reel を参照します
generate_clip · get_clip_status	写真をアニメーション化して動画クリップにします（Runway）。ジョブの状態を確認します
edit_image	AI による写真編集 — バーチャルステージング、トワイライト、アップスケール、季節の演出、置換／削除／追加、手動編集
add_timeline_audio · add_timeline_overlay	ナレーション／音楽／音声、または画像／テキストのオーバーレイを配置します
move_timeline_element · reorder_timeline	タイムラインのタイミング／順序を変更します
render_movie	タイムラインを組み立てて最終的な物件紹介動画を作成します
list_endpoints · api_request	API カタログを確認／任意のルートを呼び出します — あらゆる操作に対応する手段です

有料プランと無料プラン

MCP 経由での書き込みと生成には有料プランが必要です — 無料アカウントは読み取り専用です（プロジェクト、クリップ、ムービーの参照）。whoami はこの情報を事前に報告します。書き込みがブロックされると 403 MCP_PAID_PLAN_REQUIRED が返されます。プランについては tryreelestate.com をご覧ください。

認証の仕組み

first tool call
   │   StreamableHTTP client ──► backend /mcp  (401, needs auth)
   ▼
opens your browser ──► Clerk OAuth (authorization code + PKCE, public client)
   │                                                   │
   ▼                                                   ▼
loopback http://localhost:8765/callback?code=…   access + refresh tokens
   │                                                   │
   └────────────► finishAuth(code) ──► tokens cached ──┘  (~/.reel-estate-mcp)

every later call:  callTool("api_request", …) over the authed /mcp connection

• 共有するシークレットは不要です — パブリッククライアントと PKCE を使用し、ユーザーごとにブラウザーでログインします。
• 本番環境に対応 — バックエンドが /mcp で提供するものと同じ OAuth を使用します。
• 認証の権限はバックエンドに一元化されています — このブリッジがトークンを発行することはありません。

トラブルシューティング

問題	対処方法
ログインプロンプトが表示されない／「認証されていません」	任意のツール（または login）を実行し、表示された URL を開いて承認してください。
アカウントの切り替え／再認証	logout を実行するか、~/.reel-estate-mcp を削除してください。
書き込みがブロックされる（403 MCP_PAID_PLAN_REQUIRED）	作成／生成／レンダリングには有料プランが必要です。無料アカウントは読み取り専用です。tryreelestate.com をご覧ください。

アーキテクチャ

• src/config.ts — 検証済みの環境設定（このパッケージのフォルダーから読み込みます）。/mcp URL、OAuth ストアのディレクトリ、コールバックポート、読み取り専用フラグ、デフォルトのクライアント ID を導出します。
• src/oauth.ts — OAuthClientProvider：パブリックな client_id を使用し、トークンと PKCE 検証コードをキャッシュして、システムブラウザーを開きます。
• src/upstream.ts — /mcp への OAuth 認証済み MCP クライアント接続を一元管理します（ループバックのコールバックサーバーを含む）。callTool / callApiRequest のプロキシ機能を提供します。
• src/api-client.ts — callApiRequest を使用する ApiClient。読み取り専用を強制します。
• src/catalog.ts — list_endpoints が提示するエンドポイントカタログ。
• src/tools.ts — 通常の関数として実装したツール（スモークテスト可能）。
• src/index.ts — ツールを MCP ツールとして stdio 経由で登録します。

ツールの追加

1. src/tools.ts に async function fooBar(api, args) を追加します（/mcp 経由でプロキシされる api.get(...) / api.request(...) を使用します）。
2. src/index.ts で Zod の inputSchema を指定して登録します。
3. GET の場合は scripts/smoke.ts に追加します。

すべての操作はすでに api_request 経由で利用できます。利便性を高めるツールは、よく使われる手順を第一級の機能として提供するものです。

Reel Estate について

Reel Estate は、不動産エージェントやマーケターが、通常の物件写真をプロ品質の物件動画に変換できるよう支援します。AI バーチャルステージング、夕景への変換、モーション／ドローン映像、ナレーション、Instagram、TikTok、YouTube 向けのワンクリックレンダリングに対応しています。この MCP サーバーを使うと、こうしたワークフローを AI アシスタントに取り込めます。tryreelestate.com で始めましょう →

---

キーワード：不動産動画ジェネレーター、AI 物件紹介動画、バーチャルステージング、MCP サーバー、Model Context Protocol、Claude、Cursor、物件動画マーケティング、不動産ドローン動画、写真の夕景編集。