Vidu API
工作台
文档
登录

MCP Stdio 协议

系统组件

该系统的主要组件: 1. UVX MCP 服务器
  • 基于 Python 的云端服务器
  • 直接与 Vidu API 通信
  • 提供完整的视频生成功能

安装与配置

前提条件

  1. Python 3.10 或更新版本
  2. UV/UVX
  3. Vidu API 密钥**:从 Vidu Platform 获取 (API Credits 需要从Vidu Platform购买)

获取依赖

  1. Python
    • 从 Python 官网 下载并安装
    • 确保将 Python 添加到系统路径
  2. UV/UVX
    • 通过下面方式下载UV / UVX
    • mac/linux
curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

如何使用 MCP Server

  1. 获取 Vidu API 密钥

  • 注册/登录您的账户
  • 在个人设置中创建并复制您的 API 密钥
  1. 下载必要依赖

  • Python:安装 Python 3.10 或更高版本
  • UV/UVX:安装最新稳定版的 UV & UVX
  1. 配置 MCP 客户端

  • 打开您的 MCP 客户端(如 Claude for Desktop 或 Cursor)
  • 找到客户端设置
  • 找到并打开 mcp_config.json 文件(或相应的配置文件)
  • 根据您选择的方式添加配置:
{
"mcpServers": {
"Vidu": {
"command": "uvx",
"args": [
"vidu-mcp"
],
"env": {
"VIDU_API_KEY": "api-key-here",
"VIDU_API_HOST": "api-host-here"
}
}
}
}
  • 保存配置文件
  1. 重启 MCP 客户端或刷新 MCP 服务器

  • 完全关闭并重新打开您的 MCP 客户端
  • 或者,如果客户端支持,使用刷新 MCP 服务器选项

具体客户端配置

Claude for Desktop 配置

  1. 打开 Claude 应用
  2. 转到 Claude > 设置 > 开发者 > 编辑配置
  3. 打开 claude_desktop_config.json 文件
  4. 添加上述配置并保存
  5. 重启 Claude 应用
    • 如果连接成功, 首页不会提示任何error, 且mcp设置亮绿灯
    • 如果连接失败, 首页会提示连接失败

Cursor 配置

  1. 打开 Cursor 应用
  2. 转到设置 > Model Context Protocol
  3. 添加新服务器
  4. 填写服务器详情(与上面 JSON 配置中的信息相同)
  5. 保存并重启 or 刷新mcp server

使用示例

文生视频

通过 Claude 或 Cursor,您可以使用自然语言描述要生成的视频: 基础示例
以浅蓝色和淡琥珀色为基调的超写实时尚摄影风格,一位身着宇航服的宇航员在雾中穿行。背景由迷人的白色和金色灯光组成,营造出极简主义的静物画和令人印象深刻的全景场景。
进阶示例(带参数)
使用以下参数生成夜间城市景观视频:
提示:夜空下摩天大楼灯光闪烁,汽车灯光在道路上形成光带
模型:viduq1
风格:普通
时长:5
宽高比:16:9
分辨率:1080p
运动幅度:中等