🚀 Vidu 视频生成 API 的模型上下文协议（MCP）服务器
这是一个用于与 Vidu 视频生成 API 交互的 MCP 服务器，为用户提供了从图像生成视频的强大工具。
🚀 快速开始
本 MCP 服务器可让你轻松实现图像到视频的转换等功能。按照以下步骤，你可以快速搭建并使用该服务器。
✨ 主要特性
- 图像转视频：借助 Vidu 的人工智能模型，能够将静态图像转化为视频。
- 检查生成状态：可实时监控视频生成任务的进度。
- 上传图像：可轻松上传图像供 Vidu API 使用。
📦 安装指南
先决条件
- Node.js（v14 或更高版本）
- Vidu API 密钥（可从 Vidu 官网 获取）
- TypeScript（用于开发）
安装步骤
- 克隆此仓库：
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（可选）：帧中物体的运动幅度（"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": "12345"
}
3. 上传图像
将图像文件上传到服务器。
参数：
image_file（必需）：要上传的图像文件
🔧 技术细节
该服务器基于模型上下文协议（MCP）构建，提供了一个接口用于与 Vidu 的生成式 AI 模型交互。它处理的任务包括从图像生成视频、监控生成进度以及管理图像文件。
📚 详细文档
故障排除
-
问题 1：无法启动服务器
- 确保 Node.js 已正确安装且版本符合要求。
- 检查
package.json文件是否存在，并确保所有依赖项已正确安装。
-
问题 2：无法生成视频
- 确保 Vidu API 密钥已正确设置在
.env文件中。 - 检查网络连接，确保能够访问 Vidu 的 API 服务。
- 确保 Vidu API 密钥已正确设置在
贡献
我们欢迎社区的贡献！如果您有任何改进或功能添加的想法，请提交拉取请求。