Skip to content
MCP server

dramapack

Packages short-drama episodes into platform delivery packs with loudness and rights checks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.3.1
Listing updated
3 days ago

About dramapack

dramapack is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Raw AI-rendered episodes tend to sit at -20 to -27 LUFS while the feed around them is near -14, and ffmpeg's loudnorm can go dynamic on dialogue and lift the noise floor. dramapack handles that with constant-gain mastering to -14 LUFS, subtitles burned inside the platform safe area (a text box at most 70% of frame width), and an optional music bed that ducks under dialogue.

The package command writes numbered episodes with same-name SRT files, a clean master without subtitles, 3:4 covers, a timeline and EDL, chain-of-title and AI-disclosure documents, and a manifest with measured specs. A target flag adds fixes for TikTok Drama Center rejections such as dark edge bands. The audit gives red, yellow or green against short-drama benchmarks, covering black frames, subtitle and speech drift and likely typos, with optional checks that call a vision model you supply. A rights check flags undeclared or major-label music and fonts not licensed for commercial use.

It needs Python 3.10 or newer and ffmpeg with libass and libx264. Registered with claude mcp add dramapack -- dramapack mcp, it exposes five tools that return JSON with an ok flag and a status. Dawnwood publishes it under Apache-2.0.

Install

Run in a terminal

claude mcp add dramapack --env DRAMAPACK_VLM_API_KEY='<DRAMAPACK_VLM_API_KEY>' -- uvx dramapack

Add to claude_desktop_config.json

{
  "mcpServers": {
    "dramapack": {
      "command": "uvx",
      "args": [
        "dramapack"
      ],
      "env": {
        "DRAMAPACK_VLM_API_KEY": "<DRAMAPACK_VLM_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dramapack": {
      "command": "uvx",
      "args": [
        "dramapack"
      ],
      "env": {
        "DRAMAPACK_VLM_API_KEY": "<DRAMAPACK_VLM_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "dramapack": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "dramapack"
      ],
      "env": {
        "DRAMAPACK_VLM_API_KEY": "<DRAMAPACK_VLM_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dramapack": {
      "command": "uvx",
      "args": [
        "dramapack"
      ],
      "env": {
        "DRAMAPACK_VLM_API_KEY": "<DRAMAPACK_VLM_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "dramapack": {
      "command": "uvx",
      "args": [
        "dramapack"
      ],
      "env": {
        "DRAMAPACK_VLM_API_KEY": "<DRAMAPACK_VLM_API_KEY>"
      }
    }
  }
}

Configuration

  • DRAMAPACK_FFMPEGPath to ffmpeg (default: ffmpeg on PATH)
  • DRAMAPACK_FFPROBEPath to ffprobe (default: ffprobe on PATH)
  • DRAMAPACK_VLM_BASE_URLOptional: OpenAI-compatible base URL for audit vlm checks (your provider or a local model)
  • DRAMAPACK_VLM_API_KEYOptional: API key for that endpoint (any non-empty string for local servers)
  • DRAMAPACK_VLM_MODELOptional: vision-capable model name for audit vlm checks

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

inspect
Reports loudness, true peak and specs of an episode.
master
Masters audio to -14 LUFS and burns subtitles.
package
Builds the platform delivery package.
audit
Runs the QC audit and returns a status.
check_rights
Flags music and font rights problems.

What it does

-14 LUFS mastering
Constant-gain loudness instead of dynamic loudnorm.
Subtitle safe area
Burns subtitles inside platform limits, up to 70% of frame width.
Delivery package
Builds episodes, clean masters, covers, timelines and chain-of-title documents.
Acceptance audit
Grades an episode red, yellow or green before upload.
Rights check
Flags major-label music and unlicensed fonts.
Local QC
Runs offline unless you opt in to a vision model.

Good for

  • Prepare a series for TikTok Drama Center submission
  • Master vertical drama episodes to a -14 LUFS target
  • Produce a subtitle-free clean master from the same edit
  • Check episodes for black frames or drifting subtitles
  • Screen a music and font list for rights problems

Pricing

Open source

Free, Apache-2.0

Prices change. Check dawnwood.ai before you buy.

dramapack FAQ

What does it need installed?

Python 3.10 or newer and ffmpeg with libass and libx264 on PATH.

How do I add it to Claude Code?

Run claude mcp add dramapack -- dramapack mcp.

Does QC use the network?

Local QC makes no network calls unless you opt in to a vision-model check with your own endpoint.

What licence is it under?

Apache-2.0, and commercial use is allowed with a credit requested.

Is dramapack free?

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

How do I add dramapack to Claude Code?

Run this command in your terminal: claude mcp add dramapack --env DRAMAPACK_VLM_API_KEY='<DRAMAPACK_VLM_API_KEY>' -- uvx dramapack

What are the best alternatives to dramapack?

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

Alternatives to dramapack

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media