Raylight MCP Server

什么是 Raylight MCP Server？

Raylight MCP Server 是 Raylight 官方托管的 MCP 端点，让 Claude、ChatGPT、Cursor 等 MCP 客户端在你打开的 Raylight 项目中读取、编辑并渲染动态图形产品视频。

Raylight 是 Frames of Motion Inc. 开发的浏览器端编辑器，用于制作发布视频、App 宣传片和 3D 产品样机。你在画布上排布镜头，把动画块拖到时间轴上，并添加镜头运动和场景特效。Raylight MCP 把 AI 助手接入这个编辑器：助手先读取镜头，批量提交编辑，再渲染真实帧检查效果并修正问题；每一处修改都会实时出现在你的画布上，并且可以像你自己的操作一样撤销。

如何使用 Raylight MCP Server？

你需要一个 Raylight 账号（可免费注册，首次连接时可直接在授权页面创建）。编辑和渲染时，需要在浏览器标签页中保持项目在 raylight.app 打开；标签页可以在后台。列出项目和模板、阅读设计指南、上传素材和查看导出，不需要打开标签页。

服务器地址：

https://api.raylight.app/mcp

传输方式为 Streamable HTTP，认证方式为带 PKCE 的 OAuth 2.0。无需粘贴任何密钥：客户端首次连接时，浏览器会打开 Raylight 页面，你登录后点击 Approve 即可。为 Raylight REST API 创建的 API key 不能用于 MCP 服务器。

Claude Code

claude mcp add --transport http raylight https://api.raylight.app/mcp

然后在 Claude Code 中运行 /mcp，在浏览器中完成登录。

Claude Desktop 和 claude.ai

打开 Settings > Connectors。如果目录中有 Raylight，直接选择；否则选择 Add custom connector，粘贴 https://api.raylight.app/mcp，点击 Add，再点击 Connect，并批准 Raylight 登录。

Cursor

将服务器添加到 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）；Cursor 首次连接时会打开 Raylight 登录页：

{
  "mcpServers": {
    "raylight": {
      "url": "https://api.raylight.app/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "raylight": {
      "type": "http",
      "url": "https://api.raylight.app/mcp"
    }
  }
}

ChatGPT 和 Codex

Raylight 也提供了 ChatGPT 的说明：开启 Developer mode，用服务器地址和 OAuth 认证创建自定义连接器，然后批准登录。Codex 和其他客户端添加一个名为 raylight、地址相同的 Streamable HTTP 服务器即可。

Raylight MCP Server 的主要功能

• Raylight 官方托管，无需本地安装。
• 带 PKCE 的 OAuth 2.0：客户端永远看不到你的密码，令牌自动刷新。
• get_editor_status、list_projects、get_project_overview、get_shot_details 等读取工具，让助手在修改前先了解项目。
• 真实渲染而非预览：render_stills、render_filmstrip 和 render_waveform 展示画面帧、节奏和混音，check_sync 测量声音与画面节拍之间的偏移。
• apply_edits 单次最多提交 200 项编辑：图层、动画、镜头、灯光、声音和特效。
• upload_media 和 start_from_template 用于导入截图和从官方模板开始。
• 只有一个破坏性工具（discard_import_session）；所有编辑都落在你打开的编辑器里，可以撤销。
• 按套餐计算每周工具调用额度：Free 50 次、Hobby 1,000 次、Pro 5,000 次、Max 不限。新的 Free 和 Hobby 账号另有一次性 1,000 次的试用额度。

Raylight MCP Server 的使用场景

• 给镜头加动画：“让标题在半秒内向上滑入，并加一个缓慢推近，然后渲染第一个镜头检查效果。”
• 从模板开始：“这是我 App 的三张截图。从一个发布模板开始，把它们换进去。”
• 声音设计：“给每个剪辑点配上深沉的电影感 whoosh 音效，并给我看波形。”
• 调整节奏：“第二个镜头太慢了。收紧一点，渲染一条胶片条让我看看节奏。”
• 保持项目一致：“让整个项目的颜色和字体与第一个镜头保持一致。”

Raylight MCP Server 常见问题排查

• 编辑或渲染超时：超时几乎总是因为编辑器标签页被关闭或电脑进入睡眠。在 raylight.app 重新打开项目后重试。
• 助手提示没有连接编辑器：让它调用 list_projects，打开返回的 editUrl 后再请求编辑。
• API key 被拒绝：MCP 服务器只接受 OAuth；去掉密钥，完成浏览器登录即可。
• 一周中途调用失效：可能已用完套餐的每周额度。超出后每次调用从积分余额扣除两个积分，购买积分包可立即解除限制。