JinDaGe - el-el-san_vidu-mcp-server MCP Details

article

README

🚀 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（必需）：要转换为视频的图像 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": "一个宁静的湖与背景中的群山",
  "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 服务。

贡献

我们欢迎社区的贡献！如果您有任何改进或功能添加的想法，请提交拉取请求。

el-el-san_vidu-mcp-server