JSON2Video

JSON2Video MCP 服务

适用于 JSON2Video 的官方 模型上下文协议 服务。JSON2Video 是一款面向大规模自动化视频制作的视频 API。

将你的 AI Agent（Claude、Cursor、VS Code、Windsurf、Cline 等）连接到 JSON2Video，即可制作完整的 MP4 视频：从可重复使用的模板构建视频，添加 AI 配音、字幕、AI 生成的图像和视频，在云端渲染，然后获取可供发布的 URL。

由 JSON2Video 团队构建并维护。 此服务包含在 @json2video/cli npm 包中，并通过 stdio 在本地运行。

已列入官方 MCP Registry，名称为 com.json2video/mcp。

你可以做什么

• “制作一段介绍我们新产品的 30 秒竖屏视频，配上配音和字幕。”
• “为这 10 处房产分别渲染我的 Real estate listing 模板。”
• “创建一个每日新闻短视频模板，然后渲染今天的三条新闻。”
• “上传这个徽标，并将其作为水印添加到视频中。”
• “我还剩多少积分？”

要求

• Node.js 20 或更高版本
• JSON2Video API 密钥。免费注册，并从控制面板复制密钥。

安装

Claude Code（插件）

从此仓库安装插件。Claude Code 会提示你输入 API 密钥，并安全地保存该密钥：

/plugin install json2video --marketplace JSON2Video/json2video-mcp

对于较旧版本的 Claude Code，请先运行 /plugin marketplace add JSON2Video/json2video-mcp，然后运行 /plugin install json2video@json2video。

Claude Code（手动）

最快的方法是在项目文件夹中运行：

npm install -g @json2video/cli
json2video auth --api-key YOUR_API_KEY
json2video mcp install claude

这会将服务添加到项目的 .mcp.json，并安装 create-video 技能。对于其他编辑器，可用 cursor 或 vscode 替代 claude。也可以手动添加：

claude mcp add json2video --env JSON2VIDEO_API_KEY=YOUR_API_KEY -- npx -y @json2video/cli mcp run

Claude Desktop、Cursor、Windsurf 及其他客户端

将以下内容添加到客户端的 MCP 配置文件中（claude_desktop_config.json、~/.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json 等）：

{
  "mcpServers": {
    "json2video": {
      "command": "npx",
      "args": ["-y", "@json2video/cli", "mcp", "run"],
      "env": {
        "JSON2VIDEO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "json2video": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@json2video/cli", "mcp", "run"],
      "env": {
        "JSON2VIDEO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

保存后重启客户端。各编辑器的完整说明请参阅：MCP 服务文档。

工具

工具	功能
render_video	根据 movie JSON 或带变量的模板渲染视频。返回视频 URL。
check_status	检查视频项目的渲染状态。
validate_movie	验证 movie JSON，但不进行渲染。
list_templates	列出你账户中的模板。
list_featured_templates	列出公共模板库中的模板。
get_template	获取模板的变量或完整源代码。
save_template	将 movie JSON 保存为可重复使用的模板。
get_example	获取 movie JSON 示例。
get_help	获取有关 movie JSON 语法、元素和转场的帮助。
get_account	获取账户信息和剩余积分。
media_list	列出媒体存储中的文件。
media_get	获取文件详情和下载 URL。
media_upload	从本地路径或公共 URL 上传文件。
media_delete	删除媒体存储中的文件。

在你的机器上运行的内容

该插件和上述配置会运行 npx -y @json2video/cli mcp run。npx 会从 npm 下载已发布的 @json2video/cli 软件包，并通过标准输入输出在本地启动 MCP 服务。该服务会将你的请求（视频 JSON、模板变量、你选择上传的媒体文件）发送到 api.json2video.com 上的 JSON2Video API，并使用你的 API 密钥进行身份验证。为响应帮助和示例请求，它还会从 cdn.json2video.com 和 JSON2Video 的公共 S3 存储桶下载公开参考文件（文档、示例、语音和音乐列表）。它不会向任何其他服务发送数据。

配置

环境变量	必填	说明
JSON2VIDEO_API_KEY	是	你的 JSON2Video API 密钥。
JSON2VIDEO_TIMEOUT	否	等待渲染的最长时间，以秒为单位（默认值为 240）。

渲染会使用你的 JSON2Video 账户积分。免费账户包含可供试用的积分；请参阅定价。

资源

• JSON2Video
• 文档
• MCP 服务指南
• 使用 Claude Code 编辑视频
• npm 上的 @json2video/cli
• 支持：访问 json2video.com 上的聊天支持

许可证

MIT