Vidu Mcp Server is an MCP server that connects AI assistants to the Vidu video generation API. Developers, content creators, and automation engineers use it to transform static pictures into generated video clips directly from MCP-compatible clients like Claude Desktop and Gemini CLI. The server provides tools to handle the entire video synthesis pipeline, including uploading local images, configuring generation parameters across models such as viduq1, vidu1.5, and vidu2.0, and tracking task progress alongside credit consumption. Users can customize video duration, adjust movement amplitudes, specify resolutions up to 1080p, add background music for short clips, and set callback URLs for asynchronous completion updates. By bringing Vidu's video models into the Model Context Protocol ecosystem, it enables agents to execute multimedia generation pipelines programmatically without switching interfaces.
Category: Other & General Purpose
Tags: boilerplate, starter, template
npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude 3. Alternatively, clone the repository manually: git clone https://github.com/el-el-san/vidu-mcp-server.git 4. Navigate to the directory and install dependencies: cd vidu-mcp-server && npm install 5. Create a .env file containing your Vidu API key: VIDU_API_KEY=your_api_key_here 6. Build the server: npm run build 7. For Gemini CLI, add the server to ~/.gemini/settings.json specifying the path to build/index.js and providing VIDU_API_KEY under the env block.Part of MCP Servers
You can install it automatically for Claude Desktop using Smithery by running npx -y @smithery/cli install @el-el-san/vidu-mcp-server --client claude. Alternatively, clone the repository from GitHub, run npm install, build the TypeScript files with npm run build, and configure the resulting build/index.js in your client settings alongside your VIDU_API_KEY.
The server allows AI assistants to upload local images, trigger image-to-video generation tasks using Vidu models, and monitor job progress. Supported settings include adjusting duration between 4, 5, or 8 seconds, selecting resolutions from 360p to 1080p, setting movement amplitude, adding background music, and configuring callback URLs.
Vidu Mcp Server supports Claude Desktop via the Smithery CLI installer and Gemini CLI via its settings.json file. It also works with other standard Model Context Protocol clients capable of running Node.js server scripts.
The local image upload tool accepts PNG, WEBP, JPEG, and JPG files up to 10MB in size. For images supplied directly via web URL in generation requests, files up to 50MB are supported.