@starreel/mcp weekly downloads statistics

StarReel MCP

Turn a script into a finished, downloadable short-drama episode — from Claude, Cursor, or any MCP client.

StarReel is a prepaid AI video-production pipeline. This MCP server exposes the whole factory — 120+ tools covering every stage — so an AI agent can take a raw script all the way to a finished .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)

It is a thin, open client: all the heavy lifting (character-consistency gates, frame chaining, best-of-N auditing, billing) runs server-side at starreel.ai.

Quick start

1. Create an API key with produce scope in StarReel → Settings → API Keys (srk_live_..., shown once).
2. Add the server to Claude Code:

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

Or install the Claude Code plugin — MCP server + agent skill in one step (set STARREEL_API_KEY in your shell first):

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

1. Ask your agent: "Take this script and produce a full episode: <your script>" — it will quote each paid stage first and only spend after you confirm.

Tool-catalog language

Tool descriptions and the server instructions are authored in Simplified Chinese. Set STARREEL_MCP_LANG=en for the English edition: the server instructions (the entry-point decision tree) are shipped in English; tool descriptions are being translated in batches and any tool without an English entry yet falls back to Chinese (nothing goes blank — the startup log on stderr reports the current coverage, e.g. lang=en ⚠ English catalog 40/230). The same switch sends Accept-Language so backend-provided labels follow it:

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

Works with any MCP client

Requires Node ≥ 18 (npx). The standard config below works as-is in Cursor · Windsurf · Cline / Roo Code · Claude Desktop · Trae · Cherry Studio · Chatbox · DeepChat and any client that reads an mcpServers JSON block:

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

Clients with their own format:

<details> <summary><b>Codex CLI</b> — <code>~/.codex/config.toml</code></summary>

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

</details> <details> <summary><b>VS Code (Copilot agent mode)</b> — <code>.vscode/mcp.json</code> or user <code>mcp.json</code></summary>

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

</details> <details> <summary><b>Gemini CLI</b> — <code>~/.gemini/settings.json</code></summary>

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

</details> <details> <summary><b>No Node / can't run npx?</b> (Coze, Dify, GPTs, custom agents)</summary>

Drive the same pipeline over REST (/v1/produce/*) and paste SKILL.md into your system prompt — it carries the full workflow order, billing disciplines, and failure playbook. See the API docs.

</details>

What's inside…