🚀 Vidu 视频生成 API 的模型上下文协议（MCP）服务器

Vidu 视频生成 API 的模型上下文协议（MCP）服务器是一个强大的工具，用于与 Vidu 视频生成 API 交互，可实现从图像生成视频的功能。

🚀 快速开始

Vidu MCP 服务器能助力你轻松实现图像到视频的转换。你只需按照以下步骤操作，就能启动服务器并使用其功能。

✨ 主要特性

• 图像转视频：借助 Vidu 的人工智能模型，可将静态图像转化为视频。
• 检查生成状态：实时监控视频生成任务的进度。
• 上传图像：方便快捷地上传图像，供 Vidu API 使用。

📦 安装指南

先决条件

• Node.js（v14 或更高版本）
• Vidu API 密钥（可从 Vidu 官网 获取）
• TypeScript（用于开发）

安装步骤

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 基于 .env.template 创建一个 .env 文件并添加 Vidu API 密钥：

VIDU_API_KEY=your_api_key_here

💻 使用示例

启动服务器

1. 构建 TypeScript 代码：

npm run build

2. 启动服务器：

npm start

启动后，MCP 服务器将准备好接受来自 MCP 客户端的连接。

工具使用

基础用法

图像转视频

将静态图像转换为视频，带有可自定义的参数。

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "一个宁静的湖与背景中的群山",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

参数说明：

检查生成状态

检查视频生成任务的状态。

{
  "task_id": "12345"
}

参数说明：

上传图像

将图像文件上传到服务器。

{
  "image_file": "your_image_file"
}

参数说明：

📚 详细文档

工作原理

该服务器基于模型上下文协议（MCP）构建，提供了一个接口用于与 Vidu 的生成式 AI 模型交互。它处理的任务包括从图像生成视频、监控生成进度以及管理图像文件。

故障排除

• 问题 1：无法启动服务器
  • 确保 Node.js 已正确安装且版本符合要求。
  • 检查 package.json 文件是否存在，并确保所有依赖项已正确安装。
• 问题 2：无法生成视频
  • 确保 Vidu API 密钥已正确设置在 .env 文件中。
  • 检查网络连接，确保能够访问 Vidu 的 API 服务。

🤝 贡献

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