StarReel MCP

스크립트 하나를 완성된 다운로드 가능한 숏드라마 에피소드로 — Claude, Cursor, 또는 모든 MCP 클라이언트에서.

StarReel은 선불제 AI 비디오 제작 파이프라인입니다. 이 MCP 서버는 전체 공장 — 모든 단계를 아우르는 80개 이상의 도구 — 를 노출하므로, AI 에이전트가 원시 스크립트를 완성된 .mp4까지 가져갈 수 있습니다:

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

가벼운 오픈 클라이언트입니다. 모든 무거운 작업(캐릭터 일관성 게이트, 프레임 체이닝, best-of-N 감사, 과금)은 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 서버 + 에이전트 스킬을 한 번에 (먼저 셸에 STARREEL_API_KEY를 설정하세요):

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

3. 에이전트에게 요청하세요: "이 스크립트를 가져와 전체 에피소드를 제작해 줘: <your script>" — 먼저 각 유료 단계의 견적을 제시하고, 사용자가 확인한 후에만 비용이 발생합니다.

Related MCP server: tiktok-viral-factory

모든 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" }
    }
  }
}

동일한 파이프라인을 REST(/v1/produce/*)로 구동하고 SKILL.md를 시스템 프롬프트에 붙여넣으세요 — 전체 워크플로 순서, 과금 규율, 장애 대응 플레이북이 담겨 있습니다. API 문서를 참조하세요.

포함된 내용

프로젝트 유형: drama / ad / mv / brand_film.

과금은 설계상 에이전트 안전

• 선불제, 절대 마이너스 없음. 비용은 모든 벤더 호출 이전에 사전 승인됩니다. 잔액 부족 시 깔끔한 402를 반환하며 — 부분 실행은 없습니다.

• 지출 전 견적. 고비용 단계는 quote_* → 사용자에게 표시 → 반환된 quote_id로 generate_* 순서로 진행됩니다. 비디오의 경우 견적 == 실제 청구 금액 (동일한 함수가 둘 다 계산합니다).

• 최종 컷은 무료. 합성, 전환 효과, SFX 매칭, 결과물 패키징은 청구되지 않습니다.

• API 키는 해시로 저장되며 15분짜리 단기 토큰으로 교환됩니다. Settings에서 언제든지 취소(revoke)할 수 있습니다.

에이전트를 위해 제작: 운영 스킬

SKILL.md는 패키지에 포함되어 제공됩니다 — 플랫폼에 구애받지 않는 운영 매뉴얼(전체 파이프라인 순서 + 10가지 운영 원칙 + 장애 대응 플레이북). 스킬을 인식하는 클라이언트는 자동으로 로드합니다. npx를 실행할 수 없는 플랫폼 (Coze / Dify / GPTs / 커스텀 에이전트)에서는 시스템 프롬프트에 붙여넣고 동일한 파이프라인을 REST(/v1/produce/*)로 구동하세요.

독립형 에이전트 스킬로 설치하세요(Claude Code, Codex, Cursor, OpenCode 및 70개 이상의 에이전트) skills CLI를 통해:

npx skills add waydaxp/starreel-mcp

환경 변수

REST API (OpenAPI)

일반 REST를 선호하시나요? 전체 프로덕션 파사드는 openapi.json에 설명되어 있습니다 (OpenAPI 3.1, 100개 이상의 작업 — 이 패키지의 도구 표면에서 생성되므로 operationId가 MCP 도구 이름과 1:1로 일치합니다). 렌더링된 문서는 waydaxp.github.io/starreel-mcp에서 볼 수 있으며, 어떤 언어로든 타입 클라이언트를 생성할 수 있습니다:

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

링크

• 웹사이트: starreel.ai

• API 레퍼런스 (OpenAPI): waydaxp.github.io/starreel-mcp

• 전체 MCP / REST 문서: api.shortreelai.com/docs/mcp

• npm: @starreel/mcp

• 중국어 문서: README.zh-CN.md

라이선스

MIT — 이 클라이언트는 오픈 소스이며, 프로덕션 파이프라인은 호스팅 서비스입니다.