AI导哈

视频生成服务器

Vidu MCP Server是一个与Vidu动画生成API集成的服务器，提供使用AI模型从图像生成视频的功能。

  • by el-el-san
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 el-el-san/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请参见设置部分）

  2. 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": "https://example.com/image.jpg",
  "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中描述的相应参数的值

相关 MCP