关键词

视频生成视频编辑自动化json2video APIAI工具

项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器实现，它封装了 json2video.com 的 API，允许兼容 MCP 的客户端（如大型语言模型、自动化代理）通过标准化的工具调用方式，自动化地创建和管理视频项目。

主要功能点

  • 视频生成: 根据详细的JSON描述，通过json2video API创建包含各种元素（文本、图片、视频、音频等）和场景的视频项目。
  • 视频状态查询: 检查已提交视频生成任务的进度和结果，获取最终视频链接。
  • 模板管理: 支持创建、获取和列出json2video平台上的视频模板。
  • API认证: 通过环境变量或工具参数灵活提供json2video API密钥进行认证。
  • 易于集成: 设计用于与支持MCP协议的AI代理和自动化工具无缝协作。

安装步骤

  1. 获取 API 密钥: 首先，您需要从 json2video.com 获取您的API密钥。
  2. 安装 Node.js: 确保您的系统安装了 Node.js 和 npm（或 npx）。
  3. 运行服务器:
    • 使用 npx (推荐): 在命令行中，设置 'JSON2VIDEO_API_KEY' 环境变量并使用 npx 运行： 
      env JSON2VIDEO_API_KEY=您的_api_密钥 npx -y json2video-mcp
      （在Windows命令提示符下可能需要使用 'cmd /c "set JSON2VIDEO_API_KEY=您的_api_密钥 && npx -y json2video-mcp"'）
    • 手动安装: 通过 npm 全局安装： 
      npm install -g json2video-mcp
      然后运行（确保已设置 'JSON2VIDEO_API_KEY' 环境变量）： 
      json2video-mcp

运行成功后，服务器将通过标准输入/输出（Stdio）与MCP客户端通信。

服务器配置 (面向 MCP 客户端)

为了让您的MCP客户端（如支持MCP的IDE或代理）能够启动和使用这个服务器，您需要在客户端的配置中添加该服务器信息。典型的MCP客户端配置会要求提供以下信息：

  • 服务端名称: 客户端用来标识该服务器的唯一名称 (例如: 'json2video-mcp')。
  • 启动命令 (command): 客户端用来启动服务器的可执行命令 (例如: 'npx' 或 'json2video-mcp')。
  • 启动参数 (args): 传递给启动命令的参数列表 (例如: 如果 command 是 'npx'，args 可能是 '["-y", "json2video-mcp"]')。
  • 环境变量 (env): 启动服务器进程时需要设置的环境变量 (例如: '{ "JSON2VIDEO_API_KEY": "您的_api_密钥" }')。

请查阅您的MCP客户端文档，了解如何在其设置中添加外部MCP服务器配置。务必将 '您的_api_密钥' 替换为您的实际 json2video API 密钥。

基本使用方法

一旦MCP服务器在客户端中成功配置并连接，LLM或代理就可以“发现”它提供的工具。您可以通过自然语言描述您想进行的视频操作，例如：

  • “使用提供的图片和文本生成一个分辨率为全高清的宣传视频。” (客户端将调用 'generate_video' 工具，并根据您的描述构建相应的JSON输入)
  • “检查项目ID为 'q663vmm2' 的视频生成状态。” (客户端将调用 'get_video_status' 工具，并将项目ID作为参数传递)
  • “列出我所有的视频模板。” (客户端将调用 'list_templates' 工具)

客户端负责理解您的请求、选择合适的工具并构建正确的JSON输入发送给MCP服务器。MCP服务器接收请求，调用json2video API执行操作，并将结果返回给客户端。对于 'generate_video' 这样的异步任务，您会收到一个项目ID，然后需要使用 'get_video_status' 工具来轮询直到任务完成并获取视频URL。

信息

分类

AI与计算

访问项目