Vidu MCP

A tool that allows you to access Vidu latest video generation models via applications that support the Model Context Protocol (MCP), such as Claude or Cursor.

中文文档

Overview

Vidu MCP is a tool that allows you to access Vidu latest video generation models via applications that support the Model Context Protocol (MCP), such as Claude or Cursor. This integration enables you to generate high-quality videos anytime, anywhere — including text-to-video, image-to-video, and more.

Key Features

• Text-to-Video Generation: Generate creative videos using text prompts
• Image-to-Video Generation: Generate creative videos using text and image prompts
• Reference-to-Video Generation: Generate creative videos using text and image prompts
• StartEnd-to-Video Generation: Generate creative videos using text and image prompts

System Components

The system consists of two main 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:

Mac/Linux

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

Windows

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