Overview
What is Vidu MCP Server?
An MCP server that integrates with the Vidu video generation API. It provides tools for converting static images into videos using Vidu’s AI models, aimed at developers who want to automate video creation via MCP clients.
How to use Vidu MCP Server?
Install Node.js v14+, obtain a Vidu API key, clone the repository, run npm install, create a .env file with VIDU_API_KEY, then build (npm run build) and start (npm start). The server listens on standard input/output for MCP commands.
Key features of Vidu MCP Server
- Image-to-video conversion with customizable settings
- Check generation status of running tasks
- Upload images for use with the Vidu API
- Supports multiple models (vidu1.0, vidu1.5, vidu2.0)
- Configurable duration (4 or 8 seconds), resolution (360p/720p/1080p), and movement amplitude
- Asynchronous task management and automatic polling
- Error handling and reporting
Use cases of Vidu MCP Server
- Generate a video from a static image with a descriptive prompt
- Monitor the progress of a long-running video generation task
- Upload local images to the Vidu API before generating videos
- Integrate video creation into AI agent workflows through MCP
FAQ from Vidu MCP Server
What prerequisites are required to run Vidu MCP Server?
You need Node.js v14 or higher, a Vidu API key, and the server must be able to reach the Vidu API servers over the internet.
What tools does Vidu MCP Server provide?
Three tools: image-to-video (converts an image to video), check-generation-status (polls task progress), and upload-image (uploads a local file for use with the API).
What parameters are available for the image-to-video tool?
Required: image_url. Optional: prompt (max 1500 characters), duration (4 or 8, default 4), model (vidu1.0/1.5/2.0, default vidu2.0), resolution (360p/720p/1080p, default 720p), movement_amplitude (auto/small/medium/large), and seed for reproducibility.
What should I do if I encounter an API key error?
Verify that your Vidu API key is correctly set in the .env file as VIDU_API_KEY. Also ensure the file is in the server’s root directory.
How does Vidu MCP Server handle asynchronous tasks?
The server manages task IDs, polls for completion, and returns results. It abstracts the Vidu API’s asynchronous workflow so clients can simply check status with the check-generation-status tool.
