🚀 Vidu 视频生成 MCP 服务器
Vidu 视频生成 MCP 服务器是一个与 Vidu 视频生成 API 对接的模型上下文协议（MCP）服务器。它提供了一系列工具，能借助 Vidu 强大的 AI 模型，轻松地从图片生成视频。
🚀 快速开始
Vidu 视频生成 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
手动安装
- 克隆此仓库：
git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server
- 安装依赖项：
npm install
- 基于
.env.template创建一个.env文件，并添加你的 Vidu API 密钥：
VIDU_API_KEY=your_api_key_here
💻 使用示例
基础用法
启动服务器
- 构建 TypeScript 代码：
npm run build
- 启动服务器：
npm start
启动后，MCP 服务器将准备好接受来自 MCP 客户端的连接。
高级用法
1. 图片转视频
将静态图片转换为视频，支持自定义参数。 参数：
image_url（必填）：要转换为视频的图片 URLprompt（可选）：视频生成的文字提示（最多 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 获取下载链接。
📚 详细文档
故障排除
- 无法启动服务器：确保 Node.js 版本符合要求（v14 或更高），并且所有依赖项已正确安装。
- API 请求失败：检查网络连接，确认 Vidu API 密钥有效，并查看具体错误信息以解决问题。
- 生成视频质量低：尝试调整
model、resolution和movement_amplitude参数，找到最佳组合。
贡献
欢迎社区贡献代码或提出改进意见！请通过提交 Pull Request 的方式参与项目开发。