StarReel MCP

Convierte un guion en un episodio de drama corto terminado y descargable, desde Claude, Cursor o cualquier cliente MCP.

StarReel es un pipeline de producción de vídeo con IA prepago. Este servidor MCP expone toda la fábrica —más de 80 herramientas que cubren cada etapa— para que un agente de IA pueda llevar un guion en bruto hasta un .mp4 final:

script → AI rewrite → cast / scenes / props extraction → character portraits & sheets
       → storyboards → keyframes → video shots → voiceover (TTS) → final cut (.mp4 link)

Es un cliente abierto y ligero: todo el trabajo pesado (controles de consistencia de personajes, encadenado de fotogramas, auditoría best-of-N, facturación) se ejecuta en el servidor de starreel.ai.

Inicio rápido

1. Crea una clave de API con el permiso produce en StarReel → Settings → API Keys (srk_live_..., se muestra una sola vez).

2. Añade el servidor a Claude Code:

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

O instala el plugin de Claude Code —servidor MCP + skill de agente en un solo paso— (define primero STARREEL_API_KEY en tu shell):

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

3. Pídele a tu agente: "Toma este guion y produce un episodio completo: <your script>" — primero presupuestará cada etapa de pago y solo gastará después de que confirmes.

Related MCP server: tiktok-viral-factory

Funciona con cualquier cliente MCP

Requiere Node ≥ 18 (npx). La configuración estándar siguiente funciona tal cual en Cursor · Windsurf · Cline / Roo Code · Claude Desktop · Trae · Cherry Studio · Chatbox · DeepChat y en cualquier cliente que lea un bloque JSON mcpServers:

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

Clientes con formato propio:

[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" }
    }
  }
}

Impulsa el mismo pipeline por REST (/v1/produce/*) y pega SKILL.md en tu prompt de sistema: incluye el orden completo del flujo de trabajo, las normas de facturación y el manual de fallos. Consulta la documentación de la API.

Qué incluye

Tipos de proyecto: drama / ad / mv / brand_film.

Facturación segura para agentes por diseño

• Prepago, nunca negativo. Los costes se preautorizan antes de cualquier llamada al proveedor; si el saldo es insuficiente se devuelve un 402 limpio — nada se queda a medias.

• Presupuesta antes de gastar. Las etapas de gran importe son quote_* → mostrar al usuario → generate_* con el quote_id devuelto. Para vídeo, el presupuesto equivale al cargo real (la misma función calcula ambos).

• El montaje final es gratuito. La composición, las transiciones, la sincronización de SFX y el empaquetado de entregables no se facturan.

• Las claves de API se almacenan con hash y se intercambian por tokens de corta duración de 15 minutos; revócalas en Settings en cualquier momento.

Diseñado para agentes: el skill operativo

SKILL.md se incluye en el paquete: un manual de operación independiente de la plataforma (orden completo del pipeline + diez disciplinas operativas + un manual de fallos). Los clientes compatibles con skills lo cargan automáticamente; en plataformas que no pueden ejecutar npx (Coze / Dify / GPTs / agentes personalizados), pégalo en el prompt de sistema y ejecuta el mismo pipeline por REST (/v1/produce/*).

Instálalo como skill de agente independiente (Claude Code, Codex, Cursor, OpenCode y más de 70 agentes) mediante la CLI de skills:

npx skills add waydaxp/starreel-mcp

Variables de entorno

API REST (OpenAPI)

¿Prefieres una API REST simple? Toda la fachada de producción se describe en openapi.json (OpenAPI 3.1, más de 100 operaciones, generado a partir de la superficie de herramientas de este paquete, por lo que los operationId coinciden 1:1 con los nombres de las herramientas MCP). Explórala renderizada en waydaxp.github.io/starreel-mcp o genera un cliente tipado para cualquier lenguaje:

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

Enlaces

• Sitio web: starreel.ai

• Referencia de la API (OpenAPI): waydaxp.github.io/starreel-mcp

• Documentación completa de MCP / REST: api.shortreelai.com/docs/mcp

• npm: @starreel/mcp

• 中文文档: README.zh-CN.md

Licencia

MIT — este cliente es abierto; el pipeline de producción es un servicio alojado.