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)

これは軽量でオープンなクライアントです。重い処理（キャラクター一貫性ゲート、フレームチェーン、ベスト・オブ・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サーバーとエージェントスキルを1ステップで（先にシェルでSTARREEL_API_KEYを設定してください）:

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

3. エージェントに依頼します: 「このスクリプトからフルエピソードを制作してください: <your script>」 — 各有料ステージの見積もりを先に提示し、確認後にのみ費用が発生します。

Related MCP server: tiktok-viral-factory

あらゆるMCPクライアントで動作

Node.js ≥ 18（npx）が必要です。以下の標準設定はCursor · Windsurf · Cline / Roo Code · Claude Desktop · Trae · Cherry Studio · Chatbox · DeepChatや、mcpServersJSONブロックを読み取るあらゆるクライアントでそのまま動作します:

{
  "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でいつでも失効させることができます。

エージェント向けに構築: 運用スキル

SKILL.mdはパッケージに同梱されています — プラットフォームに依存しない運用マニュアルです（完全なパイプライン順序＋10の運用規律＋失敗時のプレイブック）。スキル対応クライアントは自動的に読み込みます。npxを実行できないプラットフォーム（Coze / Dify / GPTs / カスタムエージェント）では、システムプロンプトに貼り付けて、REST（/v1/produce/*）経由で同じパイプラインを操作します。

スタンドアロンのエージェントスキルとして（Claude Code、Codex、Cursor、OpenCode、70以上のエージェント）、skillsCLI経由でインストールできます:

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 — このクライアントはオープンです。制作パイプラインはホステッドサービスです。