mcpField
D
dramapack

dramapack

本地服务
dawnwood.ai其他01 天前更新
代码仓库访问官网

关于 dramapack

dramapack 是用于短剧交付的命令行工具和 MCP 服务，可将剧集整理为平台提交包。它整合音频母带处理、字幕、权利检查与本地质检。

主要功能

  1. 01生成平台交付包
  2. 02-14 LUFS 音频母带处理
  3. 03字幕安全区烧录
  4. 04无字幕母版与 3:4 封面
  5. 05本地质检与权利检查

适用场景

  1. 01准备平台投稿剧集
  2. 02检查音量与交付规格
  3. 03发现黑帧或字幕偏移
  4. 04核查音乐与字体权利

MCP 相关

dramapack 作为 MCP 服务向 AI Agent 提供 inspect、master、package、audit 和 check_rights 工具，结果包含 JSON 状态字段。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dawnwood-ai-dramapack": {
      "command": "uvx",
      "args": [
        "dramapack"
      ],
      "env": {
        "DRAMAPACK_FFMPEG": "<DRAMAPACK_FFMPEG>",
        "DRAMAPACK_FFPROBE": "<DRAMAPACK_FFPROBE>",
        "DRAMAPACK_VLM_BASE_URL": "<DRAMAPACK_VLM_BASE_URL>",
        "DRAMAPACK_VLM_API_KEY": "<DRAMAPACK_VLM_API_KEY>",
        "DRAMAPACK_VLM_MODEL": "<DRAMAPACK_VLM_MODEL>"
      }
    }
  }
}
启动命令uvx dramapack
需要配置的环境变量
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_KEY密钥Optional: API key for that endpoint (any non-empty string for local servers)
DRAMAPACK_VLM_MODELOptional: vision-capable model name for audit vlm checks

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypidramapack0.2.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

dramapack

tests License: Apache-2.0 MCP server

dramapack 可将短剧剧集（竖屏剧、微短剧、AI 剧）转换为可直接提交至平台的交付包，适用于 TikTok Drama Center / DramaWave / ReelShort：包含提交材料、-14 LUFS 母带处理、在字幕安全区域内烧录字幕、无字幕母版、3:4 封面、本地质检（黑帧、字幕与语音对齐、可选的自带视觉模型检查）以及音乐/字体版权检查。可通过命令行使用，也可作为 MCP 服务供 AI Agent 使用。

阅读中文版 · 文档 · 参考手册

为什么要用

从“剧集已经渲染完成”到“平台审核通过”，每家短剧工作室都会遇到同样的问题：

  • 提交包：编号剧集、同名 SRT、3:4 封面、无字幕母版、剪辑证明、版权链、AI 披露。每部剧都要手动处理数十个步骤。→ 交付包指南
  • 手机扬声器响度：原始 AI 渲染音频的响度为 -20 至 -27 LUFS，而信息流中的音频接近 -14。ffmpeg 的 loudnorm 还会在对话场景中悄悄切换为动态模式，并将噪声底抬高 30-50 dB。→ -14 LUFS 指南
  • 字幕安全区域：ffmpeg 默认的 384x288 ASS 画布会将所有尺寸放大约 6.7 倍；固定边距可能落在播放器控制栏下方，或超出 TikTok Drama Center 的 70% 宽度限制。→ 安全区域指南
  • 无字幕母版：确保与带字幕版本使用相同的剪辑。→ 无字幕母版指南
  • 版权规范：不使用大厂牌音乐，只使用可免费商用的字体。→ 版权检查清单
  • 上传前质检：检查剧集中的黑帧、字幕与语音不同步、语音未配字幕、可能存在的字幕错字；也可使用自带视觉模型或本地视觉模型检查 AI 视觉缺陷（手部、面部、身份漂移、乱码文字）和内容政策风险标记。免费、本地运行、无需账户；除非选择启用，否则不会发起网络请求。不包含唇形同步检查。→ 本地质检指南

安装

需要 Python >= 3.10 和 ffmpeg（包含 libass + libx264），并确保其位于 PATH 中。处理 CJK 字幕时，请安装 Noto CJK 字体（apt install fonts-noto-cjk）。

pip install dramapack
# or run without installing:
uvx dramapack --help

可选的对话密度指标和字幕/语音对齐功能： pip install "dramapack[speech]"。

60 秒快速入门

# input/ holds 01.mp4 02.mp4 ... (un-subtitled cuts) and 01.srt 02.srt ...
dramapack check-rights --input input/          # music + fonts: fix red first
dramapack package input/ out/ --title "My Show" --studio "My Studio" --bed tension
dramapack audit out/episodes/01.mp4 --cut input/01.mp4   # QC: black, subtitles, pacing
dramapack inspect out/episodes/01.mp4          # LUFS, true peak, specs

现在，out/ 中包含 episodes/（已添加字幕、响度为 -14 LUFS）及同名 .srt、clean/（无字幕、剪辑相同）、covers/（3:4）、timeline/、docs/（待签署的版权链、AI 披露）、manifest.json，以及提供给接收方的 README。添加 --platform-pairs 可将每两集剪辑为一个文件。可选的 show.json / rights.json / 封面 / 时间线示例请参见 examples/input/ 和参考手册。

面向 AI Agent

claude mcp add dramapack -- dramapack mcp

MCP 工具：inspect、master、package、audit、check_rights。每个工具均返回包含 ok 和绿色/黄色/红色 status 的 JSON。每个 CLI 子命令也支持 --json；退出码固定为 0（正常）、1（红色）、2（用法错误）、3（失败）。此仓库同时也是 Claude Code 插件（.claude-plugin/、skills/dramapack/），并已在 MCP Registry 中登记（server.json）。→ Agent 指南 · AGENTS.md · llms.txt

文档

请注明出处

dramapack 基于 Apache License 2.0 发布。可用于任何用途， 包括商业用途。我们希望您能做到以下两点。这些是请求，而非许可条件：

  • 保留 dramapack 写入交付包的生成器署名（manifest.json 中的 "generator"，以及单行的“Packaged with dramapack by Dawnwood”页脚）。
  • 在介绍使用 dramapack 的制作工作流时，提及“dramapack by Dawnwood”。

请参阅 NOTICE。引用方式：CITATION.cff。

由 AI 剧集工作室 Dawnwood 构建并用于制作 — https://dawnwood.ai/open-source/

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。