video-mcp
Enables text-to-video generation via the Replicate API, including starting a video generation from a prompt (optionally with a first-frame image), checking generation status by ID, and downloading finished videos to disk. Supports the minimax/video-01 model by default and any Replicate video model that accepts a prompt input.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@video-mcp Make a 6-second video of a red fox running through a snowy forest"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
video-mcp
An MCP server that gives Claude the ability to generate videos from text using the Replicate API.
Just ask Claude: "Make a 6-second video of a red fox running through a snowy forest" — and get a video link (or a file on your disk) a couple of minutes later.
How it works
You ──► Claude Desktop ──► video-mcp (this server) ──► Replicate API ──► video model
◄──────────── video URL / .mp4 file ◄──────────────Claude decides when to call the tools, writes a good prompt for the video model, waits for the result and shows you the link.
Related MCP server: Sora MCP Server
Tools
Tool | What it does |
| Starts video generation from a text prompt (optionally with a first-frame image). Waits up to ~50 s, then returns either the video URL or a generation ID. |
| Checks the status of a generation by ID and returns the URL when it's ready. |
| Downloads a finished video to |
Default model: minimax/video-01 (6 s, 720p). Any Replicate video model that accepts a prompt input can be used via the model argument or the VIDEO_MODEL env variable.
Setup
1. Requirements
uv (Python package manager — it installs Python and dependencies automatically)
A Replicate API token: https://replicate.com/account/api-tokens (paid, billed per generation)
2. Get the code
git clone https://github.com/kuuuuorti/video-mcp.git3. Connect to Claude Desktop
Open Claude Desktop → Settings → Developer → Edit Config and add:
{
"mcpServers": {
"video": {
"command": "uv",
"args": ["--directory", "/ABSOLUTE/PATH/TO/video-mcp", "run", "server.py"],
"env": {
"REPLICATE_API_TOKEN": "r8_your_token_here"
}
}
}
}Windows path example: "C:\\Users\\you\\video-mcp".
Restart Claude Desktop completely. The video server should appear in the tools menu.
Optional environment variables
Variable | Default | Description |
|
| Replicate model, |
|
| Where |
Example prompts
"Generate a video: a cozy coffee shop on a rainy evening, camera slowly moving towards the window"
"Make a video from this image as the first frame: https://… , the character turns and smiles"
"Check my video generation status and download it when ready"
Development
Test the server with the official MCP Inspector:
npx @modelcontextprotocol/inspector uv --directory . run server.pyTech stack
Python · MCP Python SDK · httpx (async) · Replicate HTTP API
License
MIT
Available Tools
3 toolscheck_videoA
Проверить статус генерации видео по ID и получить ссылку, когда оно готово.
Args: prediction_id: ID, который вернул generate_video.
Inputs: prediction_id (required). Returns: result
download_videoA
Скачать готовое видео на компьютер (по умолчанию в папку Videos/video-mcp).
Args: video_url: Ссылка на видео из generate_video или check_video. filename: Необязательно. Имя файла, например "fox.mp4".
Inputs: video_url (required), filename. Returns: result
generate_videoA
Сгенерировать короткое видео по текстовому описанию.
Args: prompt: Подробное описание сцены (лучше на английском), например "a red fox running through snowy forest, cinematic, slow motion". image_url: Необязательно. Ссылка на картинку, которая станет первым кадром. model: Необязательно. Модель Replicate в формате "владелец/название". По умолчанию minimax/video-01.
Генерация обычно занимает 1–5 минут. Если видео не успело сгенерироваться, инструмент вернёт ID — затем используйте check_video.
Inputs: prompt (required), model, image_url. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool maps to a distinct step in an asynchronous pipeline: creation (generate_video), polling (check_video), and retrieval (download_video). There is no overlap in purpose, and the descriptions explicitly chain them (generate returns an ID for check_video, check_video returns a URL for download_video).
All three names follow a strict verb_noun pattern (generate_video, check_video, download_video) with a shared 'video' resource noun. Fully predictable and consistent.
Three tools are minimal but each earns its place in the async generation workflow, with no bloat. It is at the low end of the scale, so slightly thin for anything beyond single-video generation.
The generate → poll → download lifecycle is fully covered, so an agent can complete the core task end to end. Minor gaps exist: no cancel/delete for a stuck prediction, no way to list past predictions, and no model discovery tool.
Maintenance
Related MCP Connectors
Generate images and video from Claude with one API key.
Make any photo or video you can describe, right from Claude.
Turn Claude into a creative studio: DNA-locked characters, images, video, voiceover — 55 tools.
Generate and edit images and create short videos inside Claude. Prepaid credits, no subscription.
Related MCP Servers
AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude Desktop and Agents to generate AI avatars and videos through the HeyGen API, providing tools to create and manage avatar videos with specified text and voice options.192 PyPI44MIT- AlicenseNot gradedqualityDmaintenanceIntegrates with OpenAI's Sora 2 API to generate, remix, and manage AI-generated videos from text prompts. Supports video creation, status monitoring, downloading, and remixing through natural language commands.207MIT
- AlicenseBqualityDmaintenanceExposes Replicate's FLUX image generation models to Claude, enabling text-to-image generation, image variations, inpainting, and edge-guided creation with 6 different FLUX models.21MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to generate, manage, and download AI-generated videos using OpenAI's Sora models, supporting text prompts, image-to-video, remixing, and more.9MIT