Reel Estate MCP

reel-estate-mcp

通过 AI 助手，将房产挂牌照片制作成电影感视频。 reel-estate-mcp 是一个 Model Context Protocol （MCP）服务，可将 Claude、Cursor 和其他 AI 助手连接到你的 Reel Estate 账户，让你用自然语言生成动态片段、使用 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。
• 后端是唯一的身份验证权威 — 此桥接服务不会签发令牌。

故障排除

问题	解决方法
没有登录提示 / “not authenticated”	运行任意工具（或 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 — 通过 stdio 将这些工具注册为 MCP 工具。

添加工具

1. 在 src/tools.ts 中添加 async function fooBar(api, args)（使用 api.get(...) / api.request(...)，它们会通过 /mcp 代理）。
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 服务、模型上下文协议、Claude、Cursor、房产视频营销、无人机房地产视频、黄昏照片编辑。