Vidu MCP Server

A Model Context Protocol (MCP) server for interacting with the Vidu video generation API. This server provides tools for generating videos from images using Vidu's powerful AI models.

Features

• Image to Video Conversion: Generate videos from static images with customizable settings
• Check Generation Status: Monitor the progress of video generation tasks
• Image Upload: Easily upload images to be used with the Vidu API

Prerequisites

• Node.js (v14 or higher)
• A Vidu API key (available from Vidu website)
• TypeScript (for development)

Installation

1. Clone this repository:

git clone https://github.com/el-el-san/vidu-mcp-server.git
cd vidu-mcp-server

2. Install dependencies:

npm install

3. Create a .env file based on the .env.template and add your Vidu API key:

VIDU_API_KEY=your_api_key_here

Usage

1. Build the TypeScript code:

npm run build

2. Start the server:

npm start

The MCP server will start and be ready to accept connections from MCP clients.

Tools

1. Image to Video

Converts a static image to a video with customizable parameters.

Parameters:

• image_url (required): URL of the image to convert to video
• prompt (optional): Text prompt for video generation (max 1500 chars)
• duration (optional): Duration of the output video in seconds (4 or 8, default 4)
• model (optional): Model name for generation ("vidu1.0", "vidu1.5", "vidu2.0", default "vidu2.0")
• resolution (optional): Resolution of the output video ("360p", "720p", "1080p", default "720p")
• movement_amplitude (optional): Movement amplitude of objects in the frame ("auto", "small", "medium", "large", default "auto")
• seed (optional): Random seed for reproducibility

Example request:

{
  "image_url": "https://example.com/image.jpg",
  "prompt": "A serene lake with mountains in the background",
  "duration": 8,
  "model": "vidu2.0",
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

2. Check Generation Status

Checks the status of a running video generation task.

Parameters:

• task_id (required): Task ID returned by the image-to-video tool

Example request:

{
  "task_id": "12345abcde"
}

3. Upload Image

Uploads an image to use with the Vidu API.

Parameters:

• image_path (required): Local path to the image file
• image_type (required): Image file type ("png", "webp", "jpeg", "jpg")

Example request:

{
  "image_path": "/path/to/your/image.jpg",
  "image_type": "jpg"
}

How It Works

The server uses the Model Context Protocol (MCP) to provide a standardized interface for AI tools. When you start the server, it listens for commands through standard input/output channels and responds with results in a structured format.

The server handles all the complexity of interacting with the Vidu API, including:

• Authentication with API keys
• File uploads and format validation
• Asynchronous task management and polling
• Error handling and reporting

Troubleshooting

• API Key Issues: Make sure your Vidu API key is correctly set in the .env file
• File Upload Errors: Check that your image files are valid and under 10MB in size
• Connection Problems: Ensure you have internet access and can reach the Vidu API servers

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.