# YouTube Dubbing MCP

> YouTube Dubbing MCP is an open-source MCP server for generative video. MCP server that dubs YouTube videos or SRT files, with one cloned voice per speaker. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://huggingface.co/spaces/miragea/youtube-dubbing-mcp
- **Repository:** https://github.com/rty2345rr/youtube-dubbing-mcp
- **MCP Registry name:** io.github.RTY2345RR/youtube-dubbing-mcp
- **Categories:** generative video, design and media
- **Listing updated:** 2026-11-14

## About

The agent does the translating and this server handles everything that touches audio. It pulls the transcript, works out who is speaking from caption markers or voice pitch, cuts a sample of each speaker from the source and clones that voice, then renders, times and mixes the dub. A project folder keeps progress, so re-running a tool reuses finished lines and never submits the same line twice.

Timing is handled with a character budget per line for the target language; lines start with the original timing and are only sped up, capped at 1.25 times, when needed, so the track matches the video length that YouTube requires. Output is organised per language with an m4a audio file, an SRT, a localized title and description and the YouTube Studio upload steps. One of the tools the README names is dubbing_extract_voice_samples.

It runs from a Docker image or via uvx, with ffmpeg bundled and no local GPU. Voices are rendered by the Miragea voice engine, which needs an API key. The README calls it open source.

## Features

- **Voice per speaker:** Samples are cut from the video itself so each speaker keeps their own cloned voice.
- **YouTube or local input:** Takes a YouTube URL, local MP4, MOV, MKV, MP3 or WAV files, or SRT and VTT subtitles.
- **Timing control:** Per-line character budgets and capped speed-up keep the dub as long as the video.
- **Upload-ready folders:** Each language gets audio, captions, a localized title and description.
- **Resumable projects:** Finished lines are reused when a tool is re-run.

## Good for

- Dub an interview into English while keeping both speakers' voices
- Produce multi-language audio tracks for a YouTube channel
- Turn an SRT file into a spoken dub
- Create localized titles and descriptions alongside audio

## Install

### Claude Code (Terminal)

```sh
claude mcp add youtube-dubbing-mcp --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- docker run -i --rm -e MIRAGEA_API_KEY docker.io/miragea/youtube-dubbing-mcp:0.1.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "youtube-dubbing-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIRAGEA_API_KEY",
        "docker.io/miragea/youtube-dubbing-mcp:0.1.0"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "youtube-dubbing-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIRAGEA_API_KEY",
        "docker.io/miragea/youtube-dubbing-mcp:0.1.0"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "youtube-dubbing-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIRAGEA_API_KEY",
        "docker.io/miragea/youtube-dubbing-mcp:0.1.0"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "youtube-dubbing-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIRAGEA_API_KEY",
        "docker.io/miragea/youtube-dubbing-mcp:0.1.0"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "youtube-dubbing-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MIRAGEA_API_KEY",
        "docker.io/miragea/youtube-dubbing-mcp:0.1.0"
      ],
      "env": {
        "MIRAGEA_API_KEY": "<MIRAGEA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `dubbing_extract_voice_samples`: Cuts a clean voice sample of each speaker from the video.

## FAQ

### What API key is needed?

A Miragea voice engine key, set as MIRAGEA_API_KEY.

### Does it need a GPU?

No. The README says there are no local models and ffmpeg is bundled.

### Who translates the text?

The connected agent's own model translates line by line within the time budget.

### How is it installed?

As a Docker image or with a single uvx command.

### Is YouTube Dubbing MCP free?

Yes. YouTube Dubbing MCP is open source, so you can use and self-host it for free.

### How do I add YouTube Dubbing MCP to Claude Code?

Run this command in your terminal: claude mcp add youtube-dubbing-mcp --env MIRAGEA_API_KEY='<MIRAGEA_API_KEY>' -- docker run -i --rm -e MIRAGEA_API_KEY docker.io/miragea/youtube-dubbing-mcp:0.1.0

### What are the best alternatives to YouTube Dubbing MCP?

The closest alternatives to YouTube Dubbing MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/youtube-dubbing-mcp
