🎛️ Seedance MCP 接入说明

通过 MCP（Model Context Protocol）在任意支持 MCP 的 AI 客户端中直接调用 Seedance 视频生成与素材管理能力

一、简介

MCP 是主流 AI 客户端（Claude Desktop、Cursor、codex 等）通用的工具协议。安装本 MCP Server 后，你可以在对话中直接用自然语言让 AI 帮你：

• 生成 Seedance 视频（文字、首帧图、参考视频、参考音频、时长、分辨率等）
• 真人素材认证（H5 活体认证，认证后生成真人素材组）
• 管理素材组（虚拟人像组 / 真人组）
• 查询素材（按素材组、状态过滤）

无需安装额外框架，只需你的 Li-Token API Key（管理后台「令牌」页面创建）。

二、环境要求

三、安装与构建

# 获取源码后
cd mcp-seedance
pnpm install
pnpm build        # 产物生成到 lib/

构建产物入口：lib/index.js（各客户端配置时指向此路径）。

四、客户端配置

所有客户端都通过 stdio 传输 连接 MCP Server，并需要提供 LITOKEN_API_KEY 环境变量。

4.1 Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "seedance": {
      "command": "node",
      "args": ["/绝对路径/mcp-seedance/lib/index.js"],
      "env": { "LITOKEN_API_KEY": "sk-你的Li-Token令牌" }
    }
  }
}

4.2 Cursor

1. Settings → MCP → Add New MCP Server
2. 类型选择 command：

命令: node /绝对路径/mcp-seedance/lib/index.js
环境变量: LITOKEN_API_KEY=sk-你的Li-Token令牌

4.3 codex CLI

编辑 ~/.codex/config.toml：

[mcp_servers.seedance]
command = "node"
args = ["/绝对路径/mcp-seedance/lib/index.js"]
env = { LITOKEN_API_KEY = "sk-你的Li-Token令牌" }

4.4 其他 MCP 客户端（通用）

任何支持 stdio 传输的 MCP 客户端，统一指向：

• command：node
• args：["/绝对路径/mcp-seedance/lib/index.js"]
• env：LITOKEN_API_KEY=sk-你的Li-Token令牌

五、可用工具

5.1 seedance_video 参数详解

5.2 素材状态说明

六、使用示例

配置完成后，直接在对话中描述需求即可：

生成一个 5 秒的 720p 视频：一个女孩在花园里跳舞，阳光透过树叶洒落

用这张图片 https://example.com/frame.jpg 作为首帧，生成 10 秒 1080p 视频

参考这个视频 https://example.com/ref.mp4 的风格，配 BGM https://example.com/bgm.mp3，生成 5 秒视频并生成音频

创建真人素材认证会话

查看我的素材组 / 列出真人素材组的素材

七、返回结果说明

视频生成成功

✅ Seedance 视频生成完成！
视频地址: https://...
时长: 5 秒
消耗 Token: 108900
（链接 24 小时有效，请及时下载）

真人认证成功

✅ 认证会话已创建（1800 秒内有效），请在浏览器打开完成活体认证：
https://...（H5 活体认证链接）
bytedToken: tok-xxxxxxxx

认证成功后再次查询返回 ✅ 真人认证成功，素材组 ID: grp-xxxxxxxx。

八、计费说明

计费基于实际消耗 token 数，按场景乘以对应倍率，Li-Token 后台直接按此扣费：

九、注意事项

• ⏱ 视频生成同步等待，通常 1-10 分钟返回
• 📏 视频长度范围 4-15 秒
• 🔗 视频链接有效期 24 小时，请及时下载
• 📎 参考素材（图片/视频/音频）需为公网可访问的 HTTPS URL，不支持本地文件
• 💰 成功才扣费，失败不扣
• 🎫 每个用户使用自己的 API Key，按各自账号计费和素材权限
• 🔐 API Key 通过环境变量 LITOKEN_API_KEY 配置，请勿写入代码或提交到仓库

十、故障排查