AI Video MCP by AITuber

AITuber MCP 服务

通过 AI 助手创建 AI 视频。生成带有 AI 旁白、画面和同步字幕的视频，适用于 YouTube Shorts、TikTok、Instagram Reels 和长视频内容。支持 AI 生成的图片、视频片段、素材库视频，以及骨骼和角色风格等热门模板。AITuber 负责撰写脚本、合成语音、生成画面和渲染视频。

一个服务，一个 URL：

https://mcp.aituber.app

AITuber | 设置指南 | API 文档

设置客户端

claude.ai 和 Claude Desktop

打开“设置”，进入“连接器”，点击“添加自定义连接器”，然后粘贴 https://mcp.aituber.app。浏览器窗口将打开，供你使用 AITuber 账户登录。完成。

Claude Code

claude mcp add --transport http aituber https://mcp.aituber.app

浏览器会打开一次，供你登录并批准访问。

ChatGPT

打开“设置”，进入“连接器”，再进入“高级”，然后启用“开发者模式”（自定义连接器必需）。添加一个新连接器，URL 填写 https://mcp.aituber.app，然后使用 AITuber 账户登录。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "aituber": {
      "url": "https://mcp.aituber.app"
    }
  }
}

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.aituber]
url = "https://mcp.aituber.app"

OpenClaw 和其他 MCP 客户端

添加远程 MCP 服务，URL 为 https://mcp.aituber.app。如果客户端支持 OAuth，请在提示时登录。如果要求提供凭据，则使用 API 密钥（见下一节）。

两种登录方式

1. 使用 AITuber 账户登录（默认）。 Claude、ChatGPT 和 Cursor 等应用会打开浏览器窗口，供你登录并批准访问。无需复制密钥，也无需存储任何内容。

2. 使用 API 密钥（服务、CI、自动化）。 如果不便通过浏览器登录（例如 VPS、CI 流水线、n8n、cron），请在 app.aituber.app/dashboard/api-keys 创建密钥（以 ak_ 开头），并将其作为 bearer token 发送到同一 URL：

claude mcp add --transport http aituber https://mcp.aituber.app \
  --header "Authorization: Bearer ak_your_key_here"

{
  "mcpServers": {
    "aituber": {
      "url": "https://mcp.aituber.app",
      "headers": {
        "Authorization": "Bearer ak_your_key_here"
      }
    }
  }
}

API 密钥有效期长，且可从控制面板撤销，因此比 OAuth 令牌更适合无人值守的自动化。

你可以做什么

• 根据提示词或脚本生成视频 - 描述一个主题即可生成完整视频，也可以提供准确的旁白文本以实现精确控制
• 短视频和长视频 - 创建 15 秒的 Shorts 或 20 分钟的视频
• 1,300 多种 AI 语音 - 按性别、口音、年龄或语言筛选
• 27 种以上的视觉风格 - 照片级写实、动漫、电影感、3D Pixar、水彩、漫画书等
• 视频模板 - 骨骼 X 光风格、角色驱动的故事
• 多种媒体类型 - AI 生成的图片、AI 视频片段或真实素材库视频
• 音乐视频 - 根据提示词生成歌曲（或上传自己的曲目），并用 AI 画面和同步歌词字幕制作音乐视频
• 六个发布平台 - 发布到 YouTube、TikTok、Instagram、Facebook、Threads 和 X
• 导出为 MP4 - 渲染并下载最终视频
• 查看额度和套餐 - 生成前查看用量

开始创作

向 AI 助手提问：

“创建一段 60 秒的视频，介绍 5 个令人惊叹的海洋事实”

“列出可用于旁白的英国女性语音”

“查看我还剩多少额度”

“将我最新的视频导出为 MP4，并提供下载链接”

“列出我已连接的频道，并将完成的视频发布到 Threads 和 X”

工作原理

该服务提供常用流程对应的命名工具，以及三个用于处理 API 其他功能的通用工具。

命名工具

工具	功能
create_video	根据脚本、创意、网页或文档创建配有旁白的视频。支持模板（templateId）和虚拟形象（mediaType: "avatar"）。消耗点数。
create_music_video	根据歌曲或上传的音轨创建音乐视频。消耗点数。
get_video	获取单个视频及其状态。创建后轮询此工具。
list_videos	列出你账户中的视频。
export_video	将已完成的视频渲染为 MP4。需要付费套餐。
publish_video	立即或按计划将已完成的视频发布到已连接的频道。
list_voices	列出 AI 旁白音色，支持筛选。
get_subscription	获取你的套餐和点数余额。
create_clip	生成一个独立的 AI 视频片段（1 到 30 秒，不含旁白）。消耗点数，需要付费套餐。
download_video	获取已导出视频的 MP4 下载链接。
list_channels	列出与你的账户连接的社交频道。
create_element	根据一张参考照片保存可重复使用的人物、产品或地点，以便在脚本中使用 @handle。

通用工具

工具	功能
search_api	查找适合任务的 API 端点。用自然语言描述你的需求。返回端点及其参数和示例。
api_read	向目录中的端点发送 GET 请求。只读。
api_write	向目录中的端点发送 POST、PUT 或 PATCH 请求。某些端点会消耗点数。
api_delete	向目录中的端点发送 DELETE 请求，例如删除视频或取消已安排的发布。

通用工具仅接受下方目录中列出的端点。

search_api("make a short clip from a prompt")
-> Returns: POST /clips with all parameters and examples

api_write(method: "POST", path: "/clips", body: {
  "prompt": "a drone shot over a glacier at sunrise",
  "durationSeconds": 5
})
-> Returns: { clipId: "abc-123", status: "pending" }

示例工作流

生成并下载 MP4

1. 搜索 - 查找用于创建视频的正确端点
2. 生成 - 使用你的脚本和设置创建视频
3. 轮询 - 检查视频状态，直到生成完成
4. 导出 - 将已完成的视频渲染为 MP4
5. 下载 - 获取 MP4 下载 URL

生成并发布

1. 生成 - 使用你的脚本和设置创建视频
2. 轮询 - 等待视频状态变为 completed
3. 列出频道 - 调用 GET /channels 查找已连接的频道 ID
4. 发布 - 调用 POST /publications，并传入 videoId 和各频道的设置
5. 轮询发布状态 - 调用 GET /publications/{publicationId}，直到状态变为 published、scheduled 或 failed

发布要求频道已通过 AITuber 仪表板连接，并且拥有启用了 Publish 功能的有效付费套餐。如果视频尚未导出，API 会自动开始导出。

生成音乐视频

1. 制作歌曲 - 调用 POST /music 并传入提示词（或通过 POST /uploads 上传音轨，并将用途设为 music）
2. 轮询歌曲 - 调用 GET /music/{id}，直到状态变为 completed
3. 制作视频 - 调用 POST /music-videos 并传入 musicId（或 musicAssetId）以及 visualMode（ai-images、ai-video 或 cover-image）
4. 轮询视频 - 调用 GET /videos/{id}，直到状态变为 completed，然后导出或发布视频

API 端点

端点	描述
GET /voices	浏览 1,300 多种 AI 语音并使用筛选条件（公开，无需身份验证）
GET /voices/cloned	列出你在控制面板中克隆的语音
GET /avatars	列出用于口播视频的虚拟形象
GET /elements	列出已保存的人物、产品和地点（含 @handles）
POST /elements	从照片 URL 或上传的素材中保存元素
POST /uploads	上传媒体（通过 URL 或直接 PUT）
GET /ugc/reactions	列出 UGC 反应片段（素材库和你自己的片段）
POST /ugc/reactions	使用你的角色生成反应片段
GET /ugc/reactions/{id}	获取反应片段状态
POST /ugc/videos	制作完整的 UGC 开场视频
POST /music	根据提示词生成原创歌曲
GET /music	列出你生成和上传的曲目
GET /music/{id}	获取歌曲状态和音频 URL
POST /music-videos	将歌曲配上 AI 视觉效果，制作成音乐视频
POST /ideas	获取适用于某个细分领域的视频主题创意
POST /scripts	根据主题撰写旁白脚本
GET /image-styles	列出视频生成的图像风格
GET /caption-styles	列出视频生成的字幕样式
POST /videos/generate	根据脚本或创意创建视频
GET /videos	列出你的所有视频
GET /videos/{id}	获取视频详情和生成状态
DELETE /videos/{id}	删除视频
GET /clip-models	列出独立片段可用的 AI 模型及其功能和费用
POST /clips	根据提示词或图像生成独立的 AI 视频片段
GET /clips	列出你的片段
GET /clips/{id}	获取片段状态和下载 URL
GET /subscription	查看你的套餐、额度和账单信息
POST /exports	开始将视频渲染为 MP4
GET /exports/download	获取 MP4 的临时下载 URL
GET /channels	列出已连接的 YouTube、TikTok、Instagram、Facebook、Threads 和 X 频道
POST /publications	将已完成的视频发布到一个或多个已连接的频道
GET /publications/{publicationId}	发布后查看发布状态
DELETE /publications/{publicationId}	在预定发布时间到来前取消发布

支持的视频类型

类型	描述	创建方式
无真人出镜旁白（图像）	配有 Ken Burns 动画、旁白和字幕的 AI 图像	默认类型。只需发送脚本或创意。
无真人出镜旁白（视频片段）	使用 AI 生成的视频片段，而非图像	设置 mediaType: "video"
库存素材	与旁白内容匹配的真实库存素材	设置 mediaType: "stock"
骨骼模板	病毒式传播的“如果……会怎样”X 光风格	设置 templateId: "skeleton"
角色模板	由角色驱动的故事形式	设置 templateId: "character"
虚拟形象（口播）	虚拟形象对着镜头朗读你的脚本	设置 mediaType: "avatar" + avatarId + voiceId

底层实现

该服务是一个无状态的 Cloudflare Worker（src/remote.ts，源代码位于此代码库中）。它会验证你的 AITuber 登录状态或 API 密钥，从一个共享模块（src/tools.ts）注册上述工具，并使用你自己的凭据将每次调用转发到 AITuber API。不会存储任何内容，也没有服务端会话。PostHog MCP Analytics 会记录工具名称、客户端详情、耗时以及成功或失败状态。发送分析事件前，会移除工具参数和响应。端点目录由 API 的 OpenAPI 定义生成，因此工具始终与线上 API 保持一致。开发和部署说明： CONTRIBUTING.md。

链接

• AITuber - AI 视频创作工具
• 设置指南 - 从任意客户端连接
• API 文档 - 交互式 API 参考
• 控制面板 - 管理视频和账单
• API 密钥 - 创建和管理 API 密钥

许可证

MIT