MotionVid MCP Server

什么是 MotionVid MCP Server？

MotionVid MCP Server 是 MotionVid 官方托管的 MCP 端点。MotionVid 是一款可制作带旁白和音乐的动画视频的 AI 工具，借助该服务器，你的 AI 助手可以替你创建、预览、编辑和渲染视频。

MotionVid 面向希望制作讲解视频、数据视频、信息图、地图、产品广告和 b-roll 素材，却不想学设计或使用视频编辑器的创作者和营销人员。MCP 服务器把相同的生成能力带入 Claude、ChatGPT、Cursor、VS Code、Codex 等 MCP 客户端，由智能体发起的视频与网页版消耗相同的积分。

如何使用 MotionVid MCP Server？

端点为 https://motionvid.ai/mcp，传输方式为 Streamable HTTP。你需要 MotionVid 付费计划：据 MotionVid 介绍，所有付费计划均包含 MCP 访问（撰写时为 Starter 每月 $19、Pro 每月 $29、Ultimate 每月 $49、Creator 每月 $249）。认证方式为 OAuth：添加 URL 后，在浏览器中用 MotionVid 账号登录。若需无界面（headless）使用，MotionVid 也接受以 bearer token 形式发送的 API 密钥（mvk_...）；API 密钥随 Ultimate 和 Creator 计划提供。

Claude Code

claude mcp add --transport http motionvid https://motionvid.ai/mcp
claude mcp login motionvid

添加服务器本身不会启动登录；请运行 login 命令，或在会话中使用 /mcp 并选择 Authenticate。使用 API 密钥的无界面配置：

claude mcp add --transport http motionvid https://motionvid.ai/mcp \
  --header "Authorization: Bearer ${MOTIONVID_API_KEY}"

Claude Desktop 与 claude.ai

在 Claude Desktop 中依次打开 Settings、Connectors、Add custom connector（网页版请前往 claude.ai/customize/connectors）。名称填写 MotionVid，URL 填写 https://motionvid.ai/mcp，点击 Connect 并登录。

Cursor

将以下内容添加到 .cursor/mcp.json，Cursor 会打开浏览器让你登录：

{
  "mcpServers": {
    "motionvid": {
      "url": "https://motionvid.ai/mcp"
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json：

{
  "servers": {
    "motionvid": {
      "type": "http",
      "url": "https://motionvid.ai/mcp"
    }
  }
}

MotionVid 的 MCP 页面还介绍了 Codex 的配置（codex mcp add motionvid --url https://motionvid.ai/mcp，然后 codex mcp login motionvid）以及 ChatGPT 应用。

MotionVid MCP Server 的主要功能

• 提示词生成视频：描述你想要的视频，服务器会以异步任务生成包含分镜、旁白和音乐的完整视频。
• 渲染前审阅：每个分镜预览一张图片，并批准暂停中的故事板步骤。
• 用文字描述修改已完成的视频，并以新的尺寸或画面比例重新渲染。
• 可列出并应用品牌套件、动画风格和旁白声音。
• 积分可见：在助手中查看余额以及各模型的积分消耗。
• 支持自动发现的 OAuth 登录，也支持供无界面智能体使用的 bearer API 密钥。
• 确认提示：遵循工具标签的客户端（包括 Claude）会在运行会更改账号的工具前征求确认。

MotionVid 文档列出的工具包括 create_video、get_video_status、preview_video、approve_video、edit_video、render_video、list_videos、list_brand_kits、list_voices、enhance_prompt 和 get_credit_balance。由于该端点需要登录，我们的探测未能列出工具。

MotionVid MCP Server 的使用场景

• 产品发布视频：“用我们的品牌套件，为新的分析仪表盘制作一段 30 秒、16:9 的发布视频。”
• 数据叙事：“把这些季度数据做成带旁白的动画图表视频。”
• 文档或课程讲解：“制作一段讲解我们 API 认证方式的短视频。”
• 多尺寸社交广告：“把那个视频重新渲染成 9:16，用于 Reels。”
• 批量迭代：“列出我最近的五个视频，并显示仍在渲染的那个的状态。”

MotionVid MCP Server 常见问题排查

• 添加服务器后看不到工具：在 Claude Code 和 Codex 中，添加服务器不会启动 OAuth。请运行 claude mcp login motionvid（或 codex mcp login motionvid），或通过 /mcp 进行认证。
• 已登录但调用失败：请确认你的 MotionVid 账号使用的是付费计划，因为 MotionVid 的 MCP 访问随付费计划提供。
• API 密钥被拒绝：用于无界面使用的 API 密钥仅在 Ultimate 和 Creator 计划中提供；请在 MotionVid 的 API keys 页面创建，并以 Authorization: Bearer ... 发送。
• 视频似乎卡住了：生成是异步进行的。请让助手调用 get_video_status 查看，或用 cancel_video 取消任务。
• 积分不足：在开始较长的视频前，先查看 get_credit_balance 以及 list_models 中各模型的消耗。