Vidu MCP Server

MCP服务器视频

Vidu视频生成API与…合作Model Context Protocol (MCP) 服务器。Vidu强大的AI使用模型提供从图像生成动画的工具。

机能

• 从图像到动画的转换：通过可自定义的设置从静态图像生成动画

- 支持多模型：viduq1、vidu1.5、vidu2.0 - 特定于模型的时间分辨率约束 - 4秒视频BGM支持 - 用于异步通知的回调URL支持

• 确认生成状况：监视带有信用使用量信息的动画生成任务的进展
• 上传图像: Vidu API中使用的图像简单上传（最多10MB）

前提条件

• Node.js (v14以上)
• Vidu API键（Vidu网站缩略图），模板名称将采用不同的格式
• TypeScript（开発用）

安装

Smithery通过安装

史密瑟里来修改标记元素的显示属性Claude Desktop使用Vidu Video Generation Server自动安装：

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来修改标记元素的显示属性。

手动安装

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

使用方法

Gemini CLI用

1. TypeScript构建代码：

npm run build

1. Gemini CLI设定中设定Gemini CLI请参见设置部分）

1. Gemini CLI重新启动MCP装入

工具

1.从图像到动画的转换

使用可自定义的参数将静态图像转换为动态图像。

参数：

• image_url （必须）：转换为动画的图像的URL
• prompt （可选）：视频生成文本提示（最多1500个字符）
• duration （可选）：输出动画的时间（秒）（特定于模型）

- 视频1：仅5秒 - 视频1.5/视频2.0：4秒或8秒（默认值为4秒）

• model （可选）：生成用模型名（“viduq1”、“vidu1.5”、“vidu2.0”、默认“vidu2.0”）
• resolution （可选）：输出动画的分辨率（特定于模型/时间）

- 视频1（5s）: 1080p仅限 - 视频1.5/vidu2.0（4秒）：“360p”、“720p”、“1080p”（默认值“360p”） - 中1.5/中2.0（8秒）：仅限“720p”

• movement_amplitude （可选）：帧内对象的运动振幅（“auto”、“small”、“medium”、“large”、默认“auto”）
• seed （可选）：用于重现性的随机种子
• bgm （可选）：视频BGM添加（布尔，默认值false,4秒视频）
• callback_url （可选）：用于更改生成状态时的异步通知URL

请求示例：

{
  "image_url": "",
  "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设置时）是否正确设置
• 文件上传错误：图像文件有效，大小限制（10MB、直接URL图像最多50MB）进行动态观察时的轴心点
• 接続问题：有互联网接入Vidu API请确保可以到达服务器
• Gemini CLI问题:

- Gemini CLI中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积npm run build），模板名称将采用不同的格式 - settings.json路径正确build/index.js请确保指向文件 - 设置变更后Gemini CLI重新启动 - 在服务器设置中"disabled": false中描述的相应参数的值