remotion-mcp-server

Remotion（Reactベースのプログラム動画）を使って、参照動画を分析し、ブランド向けのInstagram Reels / YouTube Shortsを生成する機能をClaudeに与えるMCP（Model Context Protocol）サーバーです。チャット会話だけで完結します。

Claudeに参照リールを指定するだけで、以下のことが可能です。

1. ダウンロード（yt-dlp）し、フレームと音声を抽出して、完全な文字起こしを取得します（YouTubeのキャプションが最優先、それ以外（Instagram、TikTok、ローカルファイル）はfaster-whisperにフォールバック）。

2. 同じスタイルの新しいコンポジション（吹き出しリールや豆知識・リスト形式リール）を、実際のReact/TSXコードとして生成します。

3. RemotionでMP4にレンダリングします。

4. 最終決定する前に、Remotion Studioでシークバーを動かして確認する方法を案内します。

CapCutも手動編集も不要。Claudeが動画を書きます。

ツール

create_* ツールはどちらも、レンダリングを最終版と見なす前に、Remotion Studio（npm run dev → localhost:3000）でコンポジションを開く方法をClaude/ユーザーに伝える preview ヒントを返します。

Related MCP server: cutgent

セットアップ

1. リポジトリをクローンしてPython依存関係をインストール

git clone https://github.com/<your-username>/remotion-mcp-server.git
cd remotion-mcp-server
pip install -r requirements.txt

また、ffmpeg がPATHに含まれている必要があります（または、サーバーが自動的にフォールバックする imageio-ffmpeg をインストールしてください）。

2. Remotionプロジェクトをセットアップ

このサーバーは、生成したコンポジションを書き込んでレンダリングするためのRemotionプロジェクトを必要とします。すぐに使えるスターターが同梱されています。

cd remotion-template
npm install
cd ..

または、REMOTION_MCP_PROJECT を既存のRemotionプロジェクトに設定します。remotion-template/src/Root.tsx の2つのマーカーコメントが、その Root.tsx に存在する必要があります。

3. 設定（オプション）

デフォルトを使用しない場合（カスタムのyt-dlp/ffmpegパス、別のプロジェクトフォルダ、デフォルトの透かしなど）は、.env.example を .env にコピーして調整します。

4. Claudeに登録

Claude Desktop / Claude CodeのMCP設定に追加します。

{
  "mcpServers": {
    "remotion-video": {
      "command": "python",
      "args": ["/absolute/path/to/remotion-mcp-server/server.py"]
    }
  }
}

Claudeを再起動し、参照リールを分析して、同じスタイルの動画を生成するように依頼します。

仕組み

• analyze_video は yt-dlp でダウンロードし、ffmpeg でフレームと音声を抽出してから文字起こしします。YouTubeのキャプションは youtube-transcript-api を最初に使用し、それ以外はローカルの faster-whisper による文字起こしにフォールバックします。

• create_dialogue_reel / create_facts_reel は、.tsx コンポジションファイルをテンプレート化し、Remotionプロジェクトの Root.tsx のマーカーコメントの間に登録して、npx remotion render を呼び出します。

• 生成されたコンポジションは、ホットリロードによりRemotion Studio（npm run dev）にライブ表示されます。再起動は不要で、レンダリングを最終版と見なす前にシークバーで確認できます。

ライセンス

MIT — LICENSE を参照してください。