Vidu MCP 服务器

一个用于与 Vidu 视频生成 API 交互的模型上下文协议 (MCP) 服务器。此服务器提供使用 Vidu 强大的 AI 模型从图像生成视频的工具。

功能

• 图像到视频转换: 使用可自定义的设置从静态图像生成视频
• 检查生成状态: 监控视频生成任务的进度
• 图像上传: 轻松上传图像以与 Vidu API 一起使用

前提条件

• Node.js (v14 或更高版本)
• 一个 Vidu API 密钥 (可从 Vidu 网站 获取)
• TypeScript (用于开发)

安装

1. 克隆此存储库:

git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server

2. 安装依赖项:

npm install

3. 基于 .env.template 创建一个 .env 文件，并添加您的 Vidu API 密钥:

VIDU_API_KEY=your_api_key_here

用法

1. 构建 TypeScript 代码:

npm run build

2. 启动服务器:

npm start

MCP 服务器将启动并准备好接受来自 MCP 客户端的连接。

工具

1. 图像到视频

将静态图像转换为具有可自定义参数的视频。

参数:

• image_url (必需): 要转换为视频的图像的 URL
• prompt (可选): 视频生成的文本提示 (最多 1500 个字符)
• duration (可选): 输出视频的持续时间，以秒为单位 (4 或 8，默认为 4)
• model (可选): 用于生成的模型名称 ("vidu1.0", "vidu1.5", "vidu2.0", 默认为 "vidu2.0")
• resolution (可选): 输出视频的分辨率 ("360p", "720p", "1080p", 默认为 "720p")
• movement_amplitude (可选): 帧中对象的运动幅度 ("auto", "small", "medium", "large", 默认为 "auto")
• seed (可选): 用于重现性的随机种子

示例请求:

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "背景是山脉的宁静湖泊",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

2. 检查生成状态

检查正在运行的视频生成任务的状态。

参数:

• task_id (必需): 图像到视频工具返回的任务 ID

示例请求:

{
  "task_id": "12345abcde"
}

3. 上传图像

上传图像以与 Vidu API 一起使用。

参数:

• image_path (必需): 图像文件的本地路径
• image_type (必需): 图像文件类型 ("png", "webp", "jpeg", "jpg")

示例请求:

{
  "image_path": "/path/to/your/image.jpg",
  "image_type": "jpg"
}

工作原理

该服务器使用模型上下文协议 (MCP) 为 AI 工具提供标准化接口。当您启动服务器时，它会通过标准输入/输出通道侦听命令，并以结构化格式响应结果。

服务器处理与 Vidu API 交互的所有复杂性，包括:

• 使用 API 密钥进行身份验证
• 文件上传和格式验证
• 异步任务管理和轮询
• 错误处理和报告

故障排除

• API 密钥问题: 确保您的 Vidu API 密钥已在 .env 文件中正确设置
• 文件上传错误: 检查您的图像文件是否有效且大小小于 10MB
• 连接问题: 确保您可以访问互联网并可以访问 Vidu API 服务器

贡献

欢迎贡献！请随时提交 Pull Request。