longtake

longtake-mcp

Longtake Studio 用の MCP サーバーです。ご自身の API キーで動作する AI 動画スタジオです。このサーバーを使うと、AI エージェント（Claude Code、Codex、Cursor、任意の MCP クライアント）が、制作環境を整え、声を固定したキャラクターを配役し、Seedance 2.0 / 2.5、Veo 3.1、Gemini Omni、Kling 3.0 でテイクを撮影し、低コストで下書きを作成して 1080p で仕上げ、各レンダリングの費用を確認できます。

エージェントが開始したレンダリングは、スタジオ上でクリックした場合とまったく同じ料金が適用されます。モデルプロバイダー（BytePlus、Google、Kling、fal.ai）が、お客様自身のキーに対して公開価格で課金します。エージェントアクセス自体に利用量の計測や上乗せ料金はありません。

Longtake はソフトウェアの名前です。撮影用語の「長回し（long take）」を指すものではありません。ただし、名前の由来はそこにあります。1 つのシーンの 1 テイクが作業単位です。

エージェントが利用できる機能 — 13 個のツール

ツール	機能
studio_overview	プロジェクト、エピソード、シーン、キャラクター、アセットなど、スタジオ全体の概要を確認します
create_project · create_folder · create_scene	制作構造を作成します：プロジェクト → エピソード → シーン
create_character	ポートレートと固定音声サンプルを使ってキャラクターを配役します。スタジオではモデレーションに照らしてポートレートをスクリーンテストします
generate_mocap	4 方向のキャラクターシートを生成します（Seedream / Nano Banana Pro）
upload_asset	プロジェクトライブラリに参照画像、音声、動画クリップをアップロードします
estimate_cost	撮影前にテイクの料金を確認します。モデル、解像度、長さ、参照クリップが対象です
generate_video	テイクを撮影します。プロンプト内の @names はキャラクターとアセットに解決されます。draft: true を指定すると Seedance 2.5 の下書きを撮影します
finish_draft	Seedance 2.5 の下書きを 1080p で仕上げます。同じテイクをより鮮明にレンダリングします
take_status · scene_takes	ステータス、ファイル、トークンの使用量、テイクの撮影条件を確認します
cancel_take	テイクを削除します（キューに入った BytePlus のレンダリングはプロバイダー側でキャンセルされます）

セットアップ

1. トークンを発行します。 スタジオで、アカウントメニュー → API keys → Agent access — MCP → 作成の順に進みます。トークンは一度だけ表示され、単独で失効できます。

2. エージェントに登録します。 パッケージは npm の longtake-mcp として公開されているため、npx が取得します。クローンは不要です。Claude Code の場合：

   claude mcp add longtake \
     -e STUDIO_URL=https://longtake.studio \
     -e STUDIO_TOKEN=cf_your_token \
     -- npx -y longtake-mcp
   

   その他の MCP クライアントでも、同じコマンドと同じ 2 つの環境変数を使います。JSON 形式の場合（Cursor、Codex、Claude Desktop）：

   {
     "mcpServers": {
       "longtake": {
         "command": "npx",
         "args": ["-y", "longtake-mcp"],
         "env": { "STUDIO_URL": "https://longtake.studio", "STUDIO_TOKEN": "cf_your_token" }
       }
     }
   }
   

   チェックアウトを使う場合は、git clone https://github.com/svatrous/longtake-mcp.git && cd longtake-mcp && npm install を実行し、コマンドの参照先を node mcp-server.js にします。

トークンでできること、できないことを含む詳しいガイドは longtake.studio/mcp にあります。同じエージェント向けのプロンプト作成スキル（Seedance 2.0、Seedance 2.5、Gemini Omni、キャラクターシート）は longtake.studio/skills にあります。

安全性

トークンは作業においてお客様のアカウントとして機能します。プロバイダーのキーを使って、レート制限の範囲内でテイクを撮影します。キーの読み取りや変更、トークンの発行や失効、請求情報へのアクセスはできません。これらのルートではエージェントトークンが拒否されます。それ以外は、お客様ができることはすべて実行できます。プロジェクトの削除も可能なため、共有設定に保存しないでください。漏えいした場合は、同じダイアログから失効させてください。

ローカルファイル。 このマシン上のファイルを読み取るツールは 3 つあります。upload_asset、パスでポートレートまたは音声サンプルを指定した場合の create_character、参照写真を使う generate_mocap です。対象はメディアファイル（jpg、png、webp、gif、mp3、wav、m4a、ogg、mp4、mov）のみで、先頭バイトが実際にその形式と一致する通常のファイルに限られます。上限は 89 MB です。ディレクトリ、デバイス、パイプ、または .png に名前を変えただけのテキストファイルは、読み取りや送信の前に拒否されます。送信されるファイルはお客様のスタジオ（STUDIO_URL）に送られ、トークンに紐づくアカウント内に保存されます。それ以外の場所に送信されることはありません。

HTTPS のみ。 トークンの送信先は https://、またはこのマシン上のスタジオ（localhost、127.0.0.1、[::1]）へのプレーンな http:// に限られます。それ以外の http:// アドレスは、リクエストが行われる前に拒否されます。

ライセンス

MIT。このファイルはスタジオ独自の mcp-server.js のコピーです。スタジオでは longtake.studio/mcp-server.cjs としても提供しています。