Vidu 视频生成 MCP 服务器

与 Vidu 视频生成 API 对接的模型上下文协议（MCP）服务器。该服务器提供工具，用于通过 Vidu 的强大 AI 模型从图片生成视频。

功能

• 图片转视频：从静态图片生成视频，支持自定义设置
• 检查生成状态：监控视频生成任务的进度
• 上传图片：轻松上传图片以供 Vidu API 使用

先决条件

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

安装

通过 Smithery 安装

要自动通过 Smithery 安装 Vidu 视频生成服务器以供 Claude 桌面使用：

npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude

手动安装

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（可选）：帧中物体运动幅度（"low"、"medium"、"high"，默认 "medium"）
• fps（可选）：视频帧率（15 或 30，默认 30）

示例请求：

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "未来城市夜景",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "1080p",
  "movement_amplitude": "high",
  "fps": 30
}

2. 检查生成状态

监控视频生成任务的当前状态。

参数：

• task_id（必填）：要检查的任务 ID

示例请求：

{
  "task_id": "12345678-9abc-1234-5678-1234567890ab"
}

3. 上传图片

上传一张或多张图片以供后续处理。

参数：

• images（必填）：要上传的图片列表，支持 URL 或本地文件路径
• prompt（可选）：描述图片内容的文字提示

示例请求：

{
  "images": ["https://example.com/image1.jpg", "/local/path/image2.png"],
  "prompt": "风景照片"
}

工作原理

Vidu 视频生成 MCP 服务器通过模型上下文协议（MCP）与 Vidu 的视频生成 API 进行交互。该服务器接收客户端请求，处理图片和提示信息，并调用 Vidu API 生成相应视频内容。生成的视频文件存储在云端，用户可通过 API 获取下载链接。

故障排除

1. 无法启动服务器：确保 Node.js 版本符合要求（v14 或更高），并且所有依赖项已正确安装。
2. API 请求失败：检查网络连接，确认 Vidu API 密钥有效，并查看具体错误信息以解决问题。
3. 生成视频质量低：尝试调整 model、resolution 和 movement_amplitude 参数，找到最佳组合。

贡献

欢迎社区贡献代码或提出改进意见！请通过提交 Pull Request 的方式参与项目开发。