Vidu MCP Stdio

System Components

1. UVX MCP Server
   • Python-based cloud server
   • Communicates directly with the Vidu API
   • Provides full video generation capabilities

Installation & Configuration

Prerequisites

1. Python 3.10 or higher
2. UV/UVX
3. Vidu API Key: Obtain from Vidu Platform (This feature requires API Credits, which must be purchased separately on Vidu Platform)

Get Dependencies

1. Python:
   • Download and install from the official Python website
   • Ensure Python is added to your system path
2. UV/UVX:
   • Install uv and set up our Python project and environment:

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

How to Use MCP Server

1. Get Vidu API Key

• Visit the Vidu Platform

• Register or log into your account
• Create and copy your API key from the account settings

2. Download Required Dependencies

• Python: Install Python 3.10 or above

• UV/UVX: Install the latest stable version of UV & UVX

3. Configure MCP Client

• Open your MCP client (e.g., Claude for Desktop or Cursor)

• Locate the client settings
• Open mcp_config.json (or relevant config file)
• Add the configuration based on the method you use:

{
  "mcpServers": {
    "Vidu": {
      "command": "uvx",
      "args": [
        "vidu-mcp"
      ],
      "env": {
        "VIDU_API_KEY": "api-key-here", 
        "VIDU_API_HOST": "api-host-here"
      }
    }
  }
}

• Save the config file

4. Restart MCP Client or Refresh MCP Server

• Fully close and reopen your MCP client

• Or use the "Refresh MCP Server" option if supported

Client-specific Configuration

Claude for Desktop

1. Open the Claude application
2. Navigate to Claude > Settings > Developer > Edit Config
3. Open the claude_desktop_config.json file
   • Windows
   • Mac : /Library/Application\ Support/Claude/claude_desktop_config.json
4. Add the configuration above and save
5. Restart Claude
   • If connected successfully: the homepage will not show any error and the MCP status will be green
   • If connection fails: an error message will be shown on the homepage

Cursor

1. Open the Cursor application
2. Go to Settings > Model Context Protocol
3. Add a new server
4. Fill in the server details as in the JSON config above
5. Save and restart or refresh the MCP server

Usage Examples

Text-to-Video

In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene.

Generate a night cityscape video with the following parameters:
Prompt: Skyscraper lights twinkling under the night sky, with car lights forming streaks on the road
Model: viduq1
Style: general
Duration: 5 seconds
Aspect Ratio: 16:9
Resolution: 1080p
Movement Amplitude: middle