# starreel

An MCP server that walks a script through the whole video pipeline and hands back a link to the finished .mp4.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: starreel
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/starreel/starreel-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/starreel

## What it does

StarReel runs a prepaid AI video-production pipeline, and this server hands its tools to your agent — over 120 of them across every stage. The route goes from script to AI rewrite, then casting, scenes and props, storyboards, character portraits and sheets, keyframes, video shots, voiceover and the final cut. The heavy work — keeping characters consistent, chaining frames, auditing the best of several takes, billing — happens server-side at `starreel.ai`. The client stays thin.

Get an API key with the `produce` scope under StarReel → Settings → API Keys before anything else. It looks like `srk_live_...` and is shown once; without it the server will not start. Node 18 or newer is required since everything runs through `npx`. Tool descriptions and server instructions ship in Simplified Chinese. Setting `STARREEL_MCP_LANG=en` switches to the English edition: the entry-point instructions are in English, while tool descriptions are still being translated in waves, so anything not yet covered falls back to Chinese. The startup log on stderr shows how much is done.

Many clients work out of the box: the standard `mcpServers` block fits Cursor, Windsurf, Cline, Claude Desktop and others, while Codex CLI, VS Code and Gemini CLI each use their own config format. No Node, so `npx` is out? The same pipeline is reachable over REST at `/v1/produce/*`, and `SKILL.md` can go straight into a system prompt — it holds the step order, the billing rules and what to do when a stage fails.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `STARREEL_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add starreel -e STARREEL_API_KEY=<STARREEL_API_KEY> -- npx -y @starreel/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add starreel --env STARREEL_API_KEY=<STARREEL_API_KEY> -- npx -y @starreel/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "starreel": {
            "command": "npx",
            "args": [
                "-y",
                "@starreel/mcp"
            ],
            "env": {
                "STARREEL_API_KEY": "<STARREEL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "starreel": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@starreel/mcp"
            ],
            "env": {
                "STARREEL_API_KEY": "<STARREEL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e STARREEL_API_KEY=<STARREEL_API_KEY> starreel npx -y @starreel/mcp
```
Replace <…> with your own values

## When to use it
- turn a script into a finished `.mp4` episode without manual assembly
- keep a character's look consistent across shots
- generate storyboards and frames from an existing shot list
- add voiceover and pick music that matches a scene's mood
- translate subtitles for another language version

## Example prompts
- Take this script and produce a full episode: `<your script>`
- Quote the storyboards first, then generate them
- Compose the final cut and give me the `.mp4` link

## Similar
- [ai-video-gen](https://affpapa.org/en/nevibecode/skills/ai-video-gen.md) — skill · 1200 installs
- [runway](https://affpapa.org/en/nevibecode/skills/runway.md) — skill · 590 installs
- [video-translation](https://affpapa.org/en/nevibecode/skills/video-translation.md) — skill · 2000 installs
- [video-toolkit](https://affpapa.org/en/nevibecode/skills/video-toolkit.md) — skill · 1100 installs
- [lipsync](https://affpapa.org/en/nevibecode/skills/lipsync.md) — skill · 377400 installs
- [video](https://affpapa.org/en/nevibecode/skills/video.md) — skill · 86500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md