starreel

StarReel MCP

Claude、Cursor、または任意の MCP クライアントから、スクリプトを完成済みのダウンロード可能なショートドラマエピソードに仕上げます。

StarReel は、前払い方式の AI 動画制作パイプラインです。この MCP サーバーは、すべての工程をカバーする 120 以上のツールを備えた制作工程全体を公開し、AI エージェントが未加工のスクリプトから完成した .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)

薄くオープンなクライアントであり、キャラクターの一貫性チェック、フレームの連結、ベスト・オブ・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 starreel/starreel-mcp
/plugin install starreel@starreel

3. エージェントに次のように依頼します。「このスクリプトを使って、エピソード全編を制作してください：<your script>」 — まず有料の各工程の見積もりを提示し、確認後にのみ費用を使います。

ツールカタログの言語

ツールの説明とサーバーの指示は、簡体字中国語で作成されています。英語版を使うには STARREEL_MCP_LANG=en を設定してください。サーバーの指示（エントリーポイントの 判定ツリー）は英語で提供されます。ツールの説明は順次翻訳中で、英語版がまだない ツールは中国語にフォールバックします（空欄にはなりません。起動時のログが stderr に 現在の翻訳状況を出力します。例：lang=en ⚠ English catalog 40/230）。この設定により Accept-Language も送信され、バックエンドから提供されるラベルにも反映されます。

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

あらゆる 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" }
    }
  }
}

プロジェクトの種類：drama / ad / mv / brand_film。

説明から声をデザインする（サンプル不要）

ナレーターやキャラクターに合う声がライブラリにない場合や、クローン作成を許可された録音がない場合は、一文だけで声をデザインできます。

ナレーターもキャラクターです（char_type は voiceover）。避けたい内容ではなく、希望する声の特徴を説明してください。年齢、性別、声質、話す速さ、雰囲気などを指定します。例：「中年男性、低く温かみのある声、ゆっくりした話し方、文末が低く下がる」。吹き替えの前に、必ずお客様に候補を1つ選んでもらってください。同じ説明でも毎回異なる人物の声が生成されます（測定された声の類似度は最低0.23）が、保存した声はすべてのセリフでクローンされます（0.85～0.90）。制限：アカウントごとに一度にデザインできるのは1つ、24時間あたり30個まで。プレビュー用の文は14～28文字。候補の保存期間は6時間です。実在の人物の声をまねる目的で、その人物の名前を指定しないでください。

課金はエージェントに安全な設計です

• 前払いで、残高がマイナスになることはありません。 費用はベンダーへの呼び出し前に事前承認されます。残高不足の場合は明確な 402 が返され、処理が中途半端に実行されることはありません。
• 支出前に見積もりを取得します。 費用の大きなステージでは、quote_* → ユーザーに提示 → 返された quote_id を指定して generate_* の順に進めます。動画の場合、見積もり額＝実際の請求額です（同じ関数で両方を計算します）。
• 最終カットは無料です。 コンポジション、トランジション、SFX のマッチング、納品物のパッケージ化には課金されません。
• API キーはハッシュ化して保存し、15分間有効な短命トークンと交換します。Settings からいつでも取り消せます。

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

SKILL.md はパッケージに同梱されています。プラットフォームに依存しない運用マニュアルで、パイプライン全体の順序、10項目の運用規律、障害対応プレイブックが記載されています。 サーバーは接続時に同じガイダンスを通知し（MCP instructions）、ツール get_capabilities_guide としても公開します。そのため、このファイルを見たことがないエージェントでも、素材の種類ごとにどのエントリーポイントを使うかを把握できます。 スキル対応クライアントは自動的に読み込みます。npx を実行できないプラットフォーム（Coze / Dify / GPTs / カスタムエージェント）では、システムプロンプトに貼り付けて、REST（/v1/produce/*）経由で同じパイプラインを実行してください。

skills CLI を使って、スタンドアロンのエージェントスキルとしてインストールできます（Claude Code、Codex、Cursor、OpenCode、および70以上のエージェント）。

npx skills add starreel/starreel-mcp

環境変数

REST API（OpenAPI）

プレーンな REST をお使いですか？本番環境向けの完全なファサードは openapi.json に記載されています（OpenAPI 3.1、100以上の操作。このパッケージのツール一覧から生成されるため、operationId は MCP ツール名と1対1で対応します）。 starreel.github.io/starreel-mcp でレンダリングされた内容を確認するか、任意の言語向けに型付きクライアントを生成できます。

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

リンク

• Webサイト：starreel.ai
• API リファレンス（OpenAPI）：starreel.github.io/starreel-mcp
• MCP / REST の全ドキュメント：api.shortreelai.com/docs/mcp
• npm：@starreel/mcp
• 中国語ドキュメント：README.zh-CN.md

ライセンス

MIT — このクライアントはオープンですが、本番パイプラインはホスト型サービスです。