starreel

StarReel MCP

在 Claude、Cursor 或任何 MCP 客户端中，将脚本制作成完整、可下载的短剧集。

StarReel 是一套预付费 AI 视频制作流水线。这个 MCP 服务开放了整套制作流程——涵盖各个阶段的 120 多种工具——让 AI Agent 能将原始脚本一路制作成完整的 .mp4：

script → AI rewrite → cast / scenes / props extraction → storyboards
       → character portraits & sheets (anchor the people) + scene plates (anchor the backdrops)
       → keyframes → video shots → voiceover (TTS) → final cut (.mp4 link)

它是一个轻量的开源客户端：所有繁重工作（角色一致性检查、帧衔接、最佳结果审核、计费）都在 starreel.ai 服务端运行。

快速开始

1. 在 StarReel → Settings → API Keys 中创建一个具有 produce 权限范围的 API 密钥 （srk_live_...，仅显示一次）。
2. 将服务添加到 Claude Code：

claude mcp add starreel -e STARREEL_API_KEY=srk_live_xxx -- npx -y @starreel/mcp

或者安装 Claude Code 插件，一步完成 MCP 服务和 Agent 技能的安装 （请先在 shell 中设置 STARREEL_API_KEY）：

/plugin marketplace add starreel/starreel-mcp
/plugin install starreel@starreel

3. 向 Agent 提出请求：“使用这份脚本制作完整剧集：<your script>”—— 它会先为每个付费阶段报价，只有在你确认后才会开始消费。

工具目录语言

工具描述和服务指令以简体中文编写。设置 STARREEL_MCP_LANG=en 可切换到英文版：服务指令（入口决策树）提供英文版本；工具描述正分批翻译， 尚未提供英文版本的工具会回退到中文（不会出现空白——启动日志会在 stderr 中显示当前覆盖情况，例如 lang=en ⚠ English catalog 40/230）。此设置 也会发送 Accept-Language，使后端提供的标签遵循该语言：

claude mcp add starreel -e STARREEL_API_KEY=srk_live_xxx -e STARREEL_MCP_LANG=en -- npx -y @starreel/mcp

兼容任何 MCP 客户端

需要 Node ≥ 18（npx）。以下标准配置可直接用于 Cursor · Windsurf · Cline / Roo Code · Claude Desktop · Trae · Cherry Studio · Chatbox · DeepChat，以及任何支持读取 mcpServers JSON 配置块的客户端：

{
  "mcpServers": {
    "starreel": {
      "command": "npx",
      "args": ["-y", "@starreel/mcp"],
      "env": { "STARREEL_API_KEY": "srk_live_xxx" }
    }
  }
}

使用专属配置格式的客户端：

[mcp_servers.starreel]
command = "npx"
args = ["-y", "@starreel/mcp"]
env = { "STARREEL_API_KEY" = "srk_live_xxx" }

{
  "servers": {
    "starreel": {
      "command": "npx",
      "args": ["-y", "@starreel/mcp"],
      "env": { "STARREEL_API_KEY": "srk_live_xxx" }
    }
  }
}

{
  "mcpServers": {
    "starreel": {
      "command": "npx",
      "args": ["-y", "@starreel/mcp"],
      "env": { "STARREEL_API_KEY": "srk_live_xxx" }
    }
  }
}

项目类型：drama / ad / mv / brand_film。

根据描述设计声音（无需样本）

如果旁白或角色在声音库中没有合适的声音，且没有经过授权的录音可供克隆，可根据一句话设计声音。

旁白也是一个角色（char_type 为 voiceover）。描述你想要的声音，而非不想要的声音——年龄、性别、音色、语速、情绪等，例如 “一位中年男性，低沉温暖的嗓音，语速缓慢，句尾逐渐下沉”。配音前务必让客户选择一个声音：相同的描述每次都会生成不同的人（测得的声音相似度最低可达 0.23），而已保存的声音会克隆到每一句台词中（0.85-0.90）。限制：每个账户一次只能设计一个声音；每 24 小时最多 30 个；预览句需为 14-28 个字符；候选声音保留 6 小时；切勿指定真实人物的名字来模仿其声音。

计费机制专为 Agent 安全而设计

• 预付费，余额绝不为负。 所有费用均在调用供应商前预先授权； 余额不足时会返回明确的 402——不会出现部分执行。
• 先报价再消费。 费用较高的阶段采用 quote_* → 向用户展示 → 使用返回的 quote_id 调用 generate_*。对于视频，报价 == 实际收费 （两者由同一函数计算）。
• 最终剪辑免费。 合成、转场、音效匹配和交付物打包均不收费。
• API 密钥经过哈希存储，并会换取有效期为 15 分钟的短期令牌；可随时在设置中撤销。

专为 Agent 打造：操作技能

SKILL.md 随软件包一同提供，是一份与平台无关的操作手册（完整的流水线顺序 + 十项操作规范 + 故障处理指南）。 服务还会在连接时通过 MCP instructions 发布相同的指导，并将其作为工具 get_capabilities_guide 提供，因此，即使 Agent 从未见过此文件，也能了解各类素材应使用哪个入口。 支持技能的客户端会自动加载；在无法运行 npx 的平台（Coze / Dify / GPTs / 自定义 Agent）上，将其粘贴到系统提示词中，并通过 REST（/v1/produce/*）运行相同的流水线。

通过 skills CLI，将其安装为独立的 Agent 技能（适用于 Claude Code、Codex、Cursor、OpenCode 以及 70+ 个 Agent）：

npx skills add starreel/starreel-mcp

环境变量

REST API（OpenAPI）

更倾向于使用纯 REST？完整的生产级接口定义见 openapi.json（OpenAPI 3.1，包含 100+ 个操作——根据本软件包的工具接口生成，因此 operationId 与 MCP 工具名称一一对应）。 可在 starreel.github.io/starreel-mcp 上查看渲染版本，也可以为任何语言生成类型化客户端：

npx openapi-typescript https://raw.githubusercontent.com/starreel/starreel-mcp/main/openapi.json -o starreel.d.ts

链接

• 网站：starreel.ai
• API 参考（OpenAPI）：starreel.github.io/starreel-mcp
• 完整 MCP / REST 文档：api.shortreelai.com/docs/mcp
• npm：@starreel/mcp
• 中文文档：README.zh-CN.md

许可证

MIT — 此客户端为开源软件；生产流水线是托管服务。