Vidu MCP 服务器

这是一个用于与Vidu视频生成API交互的模型上下文协议（MCP）服务器。该服务器提供了使用Vidu强大的AI模型从图片生成视频的工具。

功能

• 图片转视频：通过可自定义设置将静态图片转换为视频
• 检查生成状态：监控视频生成任务的进度
• 图片上传：轻松上传图片以供Vidu API使用

前提条件

• 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

手动安装

1. 克隆此仓库：

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

1. 安装依赖项：

npm install

1. 根据.env.template创建一个.env文件，并添加你的Vidu API密钥：

VIDU_API_KEY=your_api_key_here

使用方法

1. 构建TypeScript代码：

npm run build

1. 启动服务器：

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": "A serene lake with mountains in the background",
  "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。