MCP Stdio 协议
系统组件
该系统的主要组件:
1. UVX MCP 服务器:
- 基于 Python 的云端服务器
- 直接与 Vidu API 通信
- 提供完整的视频生成功能
安装与配置
前提条件
- Python 3.10 或更新版本
- UV/UVX
- Vidu API 密钥**:从 Vidu Platform 获取 (API Credits 需要从Vidu Platform购买)
获取依赖
- Python
- 从 Python 官网 下载并安装
- 确保将 Python 添加到系统路径
- 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
-
获取 Vidu API 密钥
- 注册/登录您的账户
- 在个人设置中创建并复制您的 API 密钥
-
下载必要依赖
- Python:安装 Python 3.10 或更高版本
- UV/UVX:安装最新稳定版的 UV & UVX
-
配置 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"}}}}
- 保存配置文件
-
重启 MCP 客户端或刷新 MCP 服务器
- 完全关闭并重新打开您的 MCP 客户端
- 或者,如果客户端支持,使用刷新 MCP 服务器选项
具体客户端配置
Claude for Desktop 配置
- 打开 Claude 应用
- 转到 Claude > 设置 > 开发者 > 编辑配置
- 打开 claude_desktop_config.json 文件
- 添加上述配置并保存
- 重启 Claude 应用
- 如果连接成功, 首页不会提示任何error, 且mcp设置亮绿灯
- 如果连接失败, 首页会提示连接失败
Cursor 配置
- 打开 Cursor 应用
- 转到设置 > Model Context Protocol
- 添加新服务器
- 填写服务器详情(与上面 JSON 配置中的信息相同)
- 保存并重启 or 刷新mcp server
使用示例
文生视频
通过 Claude 或 Cursor,您可以使用自然语言描述要生成的视频:
基础示例:
以浅蓝色和淡琥珀色为基调的超写实时尚摄影风格,一位身着宇航服的宇航员在雾中穿行。背景由迷人的白色和金色灯光组成,营造出极简主义的静物画和令人印象深刻的全景场景。
进阶示例(带参数):
使用以下参数生成夜间城市景观视频:提示:夜空下摩天大楼灯光闪烁,汽车灯光在道路上形成光带模型:viduq1风格:普通时长:5 秒宽高比:16:9分辨率:1080p运动幅度:中等