longtake

longtake-mcp

适用于 Longtake Studio 的 MCP 服务——一款使用你自己的 API 密钥运行的 AI 视频工作室。借助此服务，AI Agent（Claude Code、Codex、Cursor 及任何 MCP 客户端）可以搭建制作项目、为角色选角并锁定其声音、使用 Seedance 2.0 / 2.5、Veo 3.1、Gemini Omni 或 Kling 3.0 拍摄镜头、低成本起草并以 1080p 完成成片，还可以查看每次渲染的费用。

Agent 发起的渲染与在工作室中点击操作的收费方式完全相同：模型提供商（BytePlus、Google、Kling、fal.ai）会按标价从你自己的密钥扣费。Agent 访问本身既不计量，也不加价。

Longtake 是软件的名称，并非电影摄影术语“长镜头”——尽管名称正是由此而来：一个场景的一次拍摄就是一个工作单位。

Agent 可使用的工具 — 共 13 个

工具	功能
studio_overview	查看项目、剧集、场景、角色和素材，一览整个工作室
create_project · create_folder · create_scene	创建制作结构：项目 → 剧集 → 场景
create_character	为角色选角，提供肖像和锁定的声音样本；工作室会对肖像进行审核测试
generate_mocap	生成四视图角色设定图（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. 向 Agent 注册令牌。 此软件包发布在 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 客户端也使用相同的命令和相同的两个环境变量。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。同一 Agent 的提示词编写技能（Seedance 2.0、Seedance 2.5、Gemini Omni、角色设定图）请访问 longtake.studio/skills。

安全

该令牌会代表你的账户执行工作：使用你的提供商密钥拍摄镜头，并遵守你的速率限制。它无法读取或更改这些密钥、创建或撤销令牌，也无法访问账单——Agent 令牌无法访问这些路由。其他你能执行的操作，它都能执行，包括删除项目，因此请勿将令牌放入共享配置中；如果令牌泄露，请在同一对话框中撤销。

本地文件。 有三个工具会读取此机器上的文件：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 提供此文件。