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 対応

MCPサーバーとして、dramapackはAIエージェントに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 のカバー画像、ローカルでの QC（黒フレーム、字幕と音声の同期、任意で独自のビジョンモデルによるチェック）、音楽／フォントの権利確認を、コマンドラインまたは AI エージェント向け MCP サーバーとして提供します。

中国語で読む · ドキュメント · リファレンス

理由

「エピソードのレンダリング完了」から「プラットフォームで受理」までの間、ショートドラマ制作スタジオでは決まって同じ問題が発生します。

  • 提出パック：連番付きのエピソード、同名の 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% ルールを超えたりします。→ セーフエリアガイド
  • 字幕付きのものと同じ編集内容であるべきクリーンマスター。→ クリーンマスターガイド
  • 権利の管理：大手レーベルの音楽を使わず、商用利用可能なフォントのみを使用します。→ 権利チェックリスト
  • アップロード前の QC：エピソード途中の黒フレーム、音声からずれていく字幕、字幕のないセリフ、字幕の誤字と思われる箇所を確認します。必要に応じて、独自のビジョンモデルまたはローカルモデルを使い、AI による映像上の不具合（手、顔、人物の同一性の不整合、文字化け）やコンテンツポリシー上のフラグも確認できます。無料でローカルに動作し、アカウントは不要です。オプトインしない限り、ネットワークへの接続はありません。リップシンクのチェックには対応していません。→ ローカル QC ガイド

インストール

Python >= 3.10 と、PATH 上の ffmpeg（libass + libx264 対応）が必要です。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/ には、同名の .srt を含む episodes/（字幕付き、-14 LUFS）、clean/（字幕なし、同じ編集内容）、covers/（3:4）、timeline/、署名用の権利の連鎖と AI に関する開示を含む docs/、manifest.json、および受領者向けの README が出力されます。2 エピソードを 1 ファイルにまとめて編集するには、--platform-pairs を追加してください。show.json／rights.json／カバー画像／タイムラインは任意です。詳細は examples/input/ とリファレンスをご覧ください。

AI エージェント向け

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）。→ エージェントガイド · AGENTS.md · llms.txt

ドキュメント

クレジット表記のお願い

dramapackはApache License 2.0のもとで公開されています。商用利用を含め、どのような用途にもご利用いただけます。次の2点にご協力いただけると幸いです。これらはお願いであり、ライセンスの条件ではありません。

  • dramapackが納品パッケージに記載する生成元クレジット（manifest.json内の"generator"と、「Packaged with dramapack by Dawnwood」の1行フッター）をそのまま残してください。
  • dramapackを使用する制作パイプラインについて説明する際は、「dramapack by Dawnwood」と記載してください。

NOTICEをご覧ください。引用する場合は、CITATION.cffをご利用ください。

AIドラマスタジオのDawnwoodが開発し、制作現場で使用しています — https://dawnwood.ai/open-source/

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。