SkillAgentSearch skills...

Ymm4MCP

No description available

GenerateConvertImprove

Install / Use

/learn @SCPgamerscp/Ymm4MCP
About this skill

Quality Score

0/100

Supported Platforms

Claude Code
Cursor

README

YMM4 MCP プラグイン

ClaudeからMCP経由でゆっくりMovieMaker4(YMM4)を操作できるようにするプラグインです。 映像を見ながら・音声を聴きながら、AIが自動でゆっくり実況・解説・茶番・ストーリー動画を生成します。

[Claude] ←MCP(stdio)→ [Python MCPサーバー] ←HTTP(8765)→ [YMM4 C#プラグイン] ←内部API→ [YMM4本体]

📁 ファイル構成

ymm4プラグイン/
├── YMM4McpPlugin/              # YMM4に読み込まれるC#プラグイン
│   ├── YMM4McpPlugin.csproj
│   ├── McpToolPlugin.cs        # IToolPlugin エントリーポイント
│   ├── McpHttpServer.cs        # HTTPサーバー (port 8765)
│   ├── McpViewModel.cs         # ViewModel (起動/停止UI)
│   ├── McpView.xaml            # コントロールパネルUI
│   ├── McpView.xaml.cs
│   └── BoolToBrushConverter.cs
├── mcp-server/                 # PythonのMCPサーバー
│   ├── server.py               # メインMCPサーバー
│   ├── requirements.txt
│   └── skills/                 # AIスキル集
│       ├── ymm4-jikkyou/       # ゆっくり実況スキル
│       │   └── SKILL.md
│       ├── ymm4-kaisetsu/      # ゆっくり解説スキル
│       │   └── SKILL.md
│       ├── ymm4-chaban/        # ゆっくり茶番スキル
│       │   └── SKILL.md
│       └── ymm4-story/         # ゆっくりストーリースキル
│           └── SKILL.md
├── claude_desktop_config_example.json
└── README.md

🚀 セットアップ手順

1. 環境変数の設定

[Environment]::SetEnvironmentVariable("YMM4_PATH", "C:\path\to\YukkuriMovieMaker4", "User")

2. YMM4プラグインのビルド

cd YMM4McpPlugin
dotnet build -c Release
# → %YMM4_PATH%\user\plugin\YMM4McpPlugin\YMM4McpPlugin.dll に自動コピー

デバッグ時の手動デプロイ：

Stop-Process -Name "YukkuriMovieMaker" -Force
Copy-Item "bin\Debug\...\YMM4McpPlugin.dll" "$env:YMM4_PATH\user\plugin\YMM4McpPlugin\" -Force
Start-Process "$env:YMM4_PATH\YukkuriMovieMaker.exe"

3. PythonのMCPサーバーのセットアップ

cd mcp-server
pip install -r requirements.txt

4. Claude Desktopの設定

%APPDATA%\Claude\claude_desktop_config.json に追加：

{
  "mcpServers": {
    "ymm4": {
      "command": "python",
      "args": ["C:/Users/ecrea/OneDrive/デスクトップ/ymm4プラグイン/mcp-server/server.py"]
    }
  }
}

5. YMM4でサーバーを起動

  1. YMM4を起動
  2. ツールメニュー → 「MCP連携サーバー」を開く
  3. 「▶ 起動」 ボタンをクリック
  4. MCPサーバー起動: http://localhost:8765/ が表示されれば完了

🌐 APIエンドポイント一覧

プロジェクト・アイテム系

| エンドポイント | 説明 | |---|---| | GET /api/status | サーバー生存確認 | | GET /api/project | プロジェクト情報（FPS・解像度等） | | GET /api/items | タイムラインの全アイテム取得 | | POST /api/project/save | プロジェクト保存 | | POST /api/timeline/duration | タイムライン長を設定 |

セリフ・アイテム操作系

| エンドポイント | 説明 | |---|---| | POST /api/voice/add | VoiceItemを1件追加 | | POST /api/script/add | 複数セリフを一括追加（文字数から長さ自動計算） | | POST /api/item/edit | アイテムのプロパティを変更 | | POST /api/item/delete | アイテムを削除（layer+frame指定） |

映像確認系

| エンドポイント | 説明 | |---|---| | GET /api/preview/capture | 現在フレームをPNG取得 | | POST /api/preview/seek | 指定フレームへシーク＋PNG取得 | | GET /api/preview/position | 現在の再生位置取得 | | POST /api/playback/play | 再生開始 | | POST /api/playback/stop | 再生停止 |

音声・映像同時取得系

| エンドポイント | 説明 | |---|---| | POST /api/preview/record | 指定秒数の音声をWAV録音 | | POST /api/preview/watch | 映像キャプチャ＋音声録音を同時実行 ★ |

🛠️ MCPツール仕様

ymm4_interact（操作系）

| action | sub_action | 説明 | |---|---|---| | get_info | status | サーバー状態確認 | | get_info | project | プロジェクト情報取得 | | get_info | items | タイムライン全アイテム取得 | | get_info | effects_list | エフェクト一覧 | | control | play | 再生 | | control | stop | 停止 | | control | save | 保存 | | add_item | voice | セリフ1件追加 | | add_script | —— | 複数セリフ一括追加（文字数→フレーム自動計算） | | edit_item | property | フレーム位置・長さ等を変更 | | edit_item | delete | アイテム削除 |

add_scriptのパラメータ：

action="add_script",
start_frame=0,       # 開始フレーム
fps=30,              # フレームレート
chars_per_sec=5,     # 話速（実況:5 / 解説:4 / 茶番:6）
lines=[
    {"layer": 7, "character": "ゆっくり霊夢",   "text": "セリフ内容"},
    {"layer": 8, "character": "ゆっくり魔理沙", "text": "セリフ内容"},
]
# 戻り値: total_frames（次のシーンのstart_frame目安）

ymm4_preview（映像・音声確認系）

| action | 説明 | |---|---| | capture | 現在フレームをPNG取得 | | seek_capture | 指定フレームへ移動してPNG取得 | | position | 現在の再生位置取得 | | record | 音声のみ録音（WAV保存） | | watch | 映像キャプチャ＋音声録音を同時実行 ★ |

watchのパラメータ：

action="watch",
frame=0,                   # 開始フレーム
duration_ms=5000,          # 録音時間（推奨: 最大8000ms）
capture_interval_ms=2000   # 画像取得間隔（推奨: 2000ms以上）
# → 音声: watch_result.wav に保存
# → 画像: PNGとしてレスポンスに含まれる

🤖 AIスキル一覧

mcp-server/skills/ 以下に動画ジャンル別のスキルがあります。 Claudeはユーザーの依頼内容に応じて自動的に対応するスキルを参照します。

キャラクター役割

| キャラ | 実況 | 解説 | 茶番 | ストーリー | |---|---|---|---|---| | 霊夢 (L7) | ボケ・マイペース | 生徒・質問役 | ボケ・天然 | 主人公・感情表現 | | 魔理沙 (L8) | ツッコミ・解説 | 解説役・先生 | ツッコミ・進行 | 相棒・行動派 |

スキル詳細

| スキル | ファイル | 話速 | 特徴 | |---|---|---|---| | ゆっくり実況 | ymm4-jikkyou/SKILL.md | 5文字/秒 | watchで映像確認しながらセリフ生成。ゲームイベントに合わせたテンプレあり | | ゆっくり解説 | ymm4-kaisetsu/SKILL.md | 4文字/秒 | 魔理沙が解説・霊夢が質問。ポイント3〜5個の構成テンプレあり | | ゆっくり茶番 | ymm4-chaban/SKILL.md | 6文字/秒 | 霊夢（ボケ）と魔理沙（ツッコミ）。ツッコミは3〜5f後に即返す | | ゆっくりストーリー | ymm4-story/SKILL.md | 4〜6文字/秒 | ナレーター(L6)追加。感動/ホラー/ファンタジー/ミステリー対応 |

💬 Claudeへの指示例

実況動画

マインクラフトのボス戦動画を見ながらゆっくり実況を作って

解説動画

スケルトンキングの攻略法をゆっくり解説動画にして
魔理沙に解説させて、霊夢に質問させて

茶番動画

霊夢と魔理沙で買い物に行く茶番コントを作って

ストーリー動画

霊夢と魔理沙が謎の洞窟を探索する短編ミステリーを作って

タイムライン確認・編集

今のタイムラインを確認して、セリフが被っているところを修正して
100フレームごとに映像と音声を確認して

📋 標準制作ワークフロー

① watchで映像を見る＋音を聴いてシーンを把握
        ↓
② シーン表と台本を設計
        ↓
③ add_scriptでシーンごとに一括配置
        ↓
④ 100fごとにseek_captureで映像・セリフを確認
        ↓
⑤ ズレ・被りをedit_itemで修正
        ↓
⑥ watchで最終確認（音声RMS・映像同期）
        ↓
⑦ 完成！プロジェクト保存

⚠️ 注意事項・既知の制限

| 項目 | 内容 | |---|---| | YMM4バージョン | v4.35以降（.NET 9 / .NET 10対応）が必要 | | watchの上限 | 画像+音声データが大きいため最大8秒程度推奨 | | 初回キャプチャ | シーク直後の1枚目は黒になることがある（描画待ち）。正常動作 | | ポート競合 | 8765が競合する場合は McpHttpServer.cs の Port を変更 | | 内部API | IMainViewModel の実装はYMM4バージョンにより異なる場合あり |

SCPgamerscp

View profile

View on GitHub
GitHub Stars4
CategoryDevelopment
Updated18d ago
Forks0
SCPgamerscp/ymm4MCP

Languages

C#

Security Score

70/100

Audited on Mar 16, 2026

No findings