JIZURA MCP & Video Studio

字面一 JIZURA ONE STOP EDITION（hirazisora氏によるfork版）をPlaywright経由で自動制御するMCP（Model Context Protocol）サーバー、およびYouTubeやローカル動画を取り込んでキネティックタイポグラフィ（リリック演出）をリアルタイムに重ねて編集・書き出せる専用WebUIアプリケーションです。

📖 HTML 利用ガイド（ビジュアル解説）

より詳細な図解・ステップ解説付きの HTML 形式ガイドを用意しています。ブラウザでそのまま閲覧できます：

• WebUI起動中: http://localhost:3000/guide.html

• ローカルファイル: docs/index.html または public/guide.html をブラウザで開く

Related MCP server: lyric-studio

🌟 主な機能と特徴

1. JIZURA Video Studio (WebUI)

   • YouTube動画自動ダウンロード: URLを入力するだけで yt-dlp により動画を取得・配置

   • ローカル動画/音声対応: MP4, MOV, WebM, MP3等をドラッグ＆ドロップで即座に読み込み

   • プレイヤートリマー & タイムスタンプ同期: 動画を再生しながら [mm:ss.ss] 形式のタイムスタンプを歌詞にワンクリック挿入

   • 🎬 テロップ配置 & スケール調整（被写体・顔避け機能）:

     • 「👇 下部テロップ（字幕風）」「🎯 中央（全画面）」「👆 上部」の配置切替

     • 50%〜100%のスケール調整と、縦オフセット微調整スライダー

     • 実写動画やキャラクター動画で「顔が文字や装飾パネルで隠れてしまう」問題を完全に防止

   • 完全透過アルファオーバーレイ合成: JIZURA公式の「透過PNG（ZIP・背景なし）」とFFmpegを連携させ、背景を完全に抜いた高品質な文字演出を動画の上に合成

2. AIエージェント連携（MCPサーバー）

   • Claude Desktopや各種MCPクライアントから自然言語でJIZURAのUIを全自動操作

   • 歌詞の流し込み、演出スタイル選択、BPM設定、チェックボックス切替、プレビュー取得、動画エクスポートに対応

🚀 クイックスタート

必要環境

• Node.js (v18以降)

• FFmpeg (macOS: brew install ffmpeg)

• yt-dlp (macOS: brew install yt-dlp ※YouTube取得時に使用)

インストール

git clone https://github.com/RimgO/jizura-mcp.git
cd jizura-mcp
npm install
npm run build

WebUIの起動

npm run ui
# ブラウザで開く: http://localhost:3000

動作確認テスト

npm run verify

🎬 WebUI の基本操作フロー

1. 動画の読み込み

   • 「YouTubeから取得」でURLを入力、または「ローカル動画をアップロード」にMP4ファイルをドラッグ＆ドロップします。

2. タイムライン同期

   • 動画を再生し、歌い出しのタイミングで「⏱️ タイムスタンプ挿入」を押すと、再生位置が [00:12.50] のように歌詞へ自動挿入されます。

3. スタイルとテロップ配置の選択

   • 演出スタイル（ノワール・クロマ、ダークHUD、墨と朱、モノ・RGBなど）を選択します。

   • 被写体の顔を遮らないために、「👇 下部テロップ (推奨)」および「標準 (65%)」がデフォルトで有効になっています。

4. プレビュー & 書き出し

   • 「プレビュー生成」で静止画を確認できます。

   • 「動画を書き出す」をクリックすると、JIZURAで透過PNG連番が書き出され、FFmpegで元動画とアルファ合成された完成MP4が生成・ダウンロードされます。

🤖 MCPクライアントへの登録（Claude Desktop等）

claude_desktop_config.json（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します：

{
  "mcpServers": {
    "jizura": {
      "command": "node",
      "args": ["/絶対パス/to/jizura-mcp/dist/index.js"]
    }
  }
}

開発中はビルドなしで実行可能：

{
  "mcpServers": {
    "jizura": {
      "command": "npx",
      "args": ["tsx", "/絶対パス/to/jizura-mcp/src/index.ts"]
    }
  }
}

チャットでの指示例

• 「この曲に合う歌詞を書いて、JIZURAでダークHUD風のタイポグラフィにしてプレビューを見せて」

• 「サビの部分だけ大きく強調して、BPM 120で動画を書き出して」

🛠️ 提供MCPツール一覧

📝 JIZURA 歌詞記法リファレンス

💡 被写体（顔など）を邪魔しないコツ 歌詞に *強調歌詞* を入れると、JIZURAはサビ演出として画面中央に巨大なパズルピースや帯プレートを出します。スッキリした文字だけの演出にしたい場合は * を外し、通常の改行や / で書くか、WebUIの「下部テロップ」モードをご利用ください。

📄 ライセンス & 著作権

• Author: RimgO

• License: MIT License

Copyright (c) 2026 RimgO

クレジット

• 字面一 JIZURA ONE STOP EDITION (hirazisora fork): https://hirazisora.github.io/JIZURA/

• JIZURA 原案・オリジナル: hirano 氏