Skip to main content
Glama

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

generate_video

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.

check_video

Checks the status of a generation by ID and returns the URL when it's ready.

download_video

Downloads a finished video to ~/Videos/video-mcp.

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

2. Get the code

git clone https://github.com/kuuuuorti/video-mcp.git

3. 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

VIDEO_MODEL

minimax/video-01

Replicate model, owner/name

VIDEO_OUTPUT_DIR

~/Videos/video-mcp

Where download_video saves files

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.py

Tech stack

Python · MCP Python SDK · httpx (async) · Replicate HTTP API

License

MIT

Available Tools

3 tools
check_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

    A4.1/5.0

    Scored across 3 tools

    Disambiguation5/5

    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).

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers