视频-MCP服务器
项目介绍
Vidu MCP 服务器
Vidu视频生成API配合使用的Model Context Protocol (MCP) 服务器。利用Vidu的强大AI模型，提供从图像生成视频的工具。
功能
- 图像转视频: 可定制设置，将静态图像转换为视频
- 支持多个模型：viduq1、vidu1.5、vidu2.0
- 各模型特有的时间与分辨率限制
- 支持4秒视频的背景音乐
- 支持异步通知的回调URL
- 生成状态检查: 监控视频生成任务进度，附带信用使用情况信息
- 图像上传: 简单上传用于Vidu API的图像（最大10MB）
前提条件
- Node.js (v14及以上版本)
- Vidu API密钥（可从Vidu网站获取）
- TypeScript（开发用途）
安装
通过Smithery安装
使用Smithery自动安装适用于Claude Desktop的Vidu视频生成服务器：
npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude
Gemini CLI配置
若要使用Gemini CLI，请在~/.gemini/settings.json中添加服务器配置：
{
"mcpServers": {
"vidu": {
"command": "node",
"args": [
"your_path/vidu-mcp-server/build/index.js"
],
"env": {
"VIDU_API_KEY": "your_api_key_here"
}
}
}
}
注意: 将your_path替换为实际的安装目录路径，将your_api_key_here替换为您的Vidu API密钥。
手动安装
- 克隆此仓库：
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
使用方法
适用于Gemini CLI
- 构建TypeScript代码：
npm run build
-
配置Gemini CLI（参见上述Gemini CLI配置部分）
-
重启Gemini CLI以加载MCP
工具
1. 图像转视频
使用可定制参数将静态图像转换为视频。
参数：
image_url(必需): 要转换为视频的图像的URLprompt(可选): 用于生成视频的文本提示（最多1500字符）duration(可选): 输出视频的时间长度（秒）（模型特定）- viduq1: 仅支持5秒
- vidu1.5/vidu2.0: 4秒或8秒（默认4秒）
model(可选): 用于生成的模型名称（"viduq1", "vidu1.5", "vidu2.0", 默认 "vidu2.0"）resolution(可选): 输出视频的分辨率（模型/时间特定）- viduq1 (5s): 仅支持1080p
- vidu1.5/vidu2.0 (4s): "360p", "720p", "1080p"（默认 "360p"）
- vidu1.5/vidu2.0 (8s): 仅支持"720p"
movement_amplitude(可选): 帧内对象运动幅度（"auto", "small", "medium", "large", 默认 "auto"）seed(可选): 用于再现性的随机种子bgm(可选): 是否向视频添加背景音乐（布尔值，默认false，仅适用于4秒视频）callback_url(可选): 生成状态变化时的异步通知URL
请求示例：
{
"image_url": "https://example.com/image.jpg",
"prompt": "以山脉为背景的宁静湖泊",
"duration": 8,
"model": "vidu2.0",
"resolution": "720p",
"movement_amplitude": "medium",
"seed": 12345,
"bgm": false
}
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"
}
故障排除
- API密钥问题: 确认Vidu API密钥已在
.env文件（手动设置情况下）或Gemini CLI配置（Gemini CLI配置情况下）中正确设置 - 文件上传错误: 确认图像文件有效且在大小限制内（upload-image工具为10MB，直接URL图像为最大50MB）
- 连接问题: 确认有互联网访问权限并能到达Vidu API服务器
- Gemini CLI问题:
- 确认在Gemini CLI配置前已构建服务器（执行
npm run build） - 确认settings.json中的路径指向正确的
build/index.js文件 - 在更改配置后重启Gemini CLI
- 确保服务器配置中
"disabled": false
- 确认在Gemini CLI配置前已构建服务器（执行