Ymm4MCP
ゆっくりムービーメーカー4のMCPです。将来的にはゆっくり動画を全自動で作れるようにしたいです。
ClaudeからMCP経由でゆっくりMovieMaker4(YMM4)を操作できるようにするプラグインです。 映像を見ながら・音声を聴きながら、AIが自動でゆっくり実況・解説・茶番・ストーリー動画を生成します。
[Claude] ←MCP(stdio)→ [Python MCPサーバー] ←HTTP(8765)→ [YMM4 C#プラグイン] ←内部API→ [YMM4本体]
🚀 はじめに(Windows)
Releases から最新版の
YMM4McpPlugin-*.ymmeをダウンロードします。YMM4を閉じて.ymmeをダブルクリックし、YMM4の案内に従ってインストールします。利用者はYMM4_PATHや .NET SDK を設定する必要はありません。YMM4を起動します。新規インストールではプラグインのHTTPサーバーが自動起動します。「ツール」→「MCP連携サーバー」で状態を確認できます。既に自動起動を無効にしている場合は、この画面の「▶ 起動」を押します。
同じ Release の
YMM4McpServer-*.zipを展開し、mcp-serverのsetup.ps1を実行します(Python 3 が必要です)。専用の仮想環境に依存関係を入れ、MCP設定に使う実際のパスを表示します。.ymmeにPythonサーバーは含まれません。Release がまだない開発版を使う場合はソースコードから同じフォルダを取得できます。cd C:\path\to\ymm4MCP\mcp-server .\setup.ps1./setup.ps1 -ConfigureClaudeDesktopを使うと、既存のmcpServersと他の設定を保持したままymm4の設定を自動追加します。既存ファイルは.bak.*に保存してから更新します。Claude Desktop を再起動して反映してください。 YMM4を起動した状態で./setup.ps1 -CheckConnectionを実行すると、接続ファイルのトークンと設定ポートを使って認証付きの/api/statusを検査できます。 プラグインのポートを変更した場合は./setup.ps1 -ConfigureClaudeDesktop -CheckConnection -Port 9000のように同じポートを指定すると、Claude Desktop のYMM4_API_BASEと接続確認に反映します。省略時は接続ファイルの設定を使います。Claude Desktopの
%APPDATA%\Claude\claude_desktop_config.jsonのmcpServers.ymm4に、setup.ps1が表示した JSON を設定します。手動設定する場合は、展開したフォルダ内の.venv\Scripts\python.exeとserver.pyの実際のパスを指定します。{ "mcpServers": { "ymm4": { "command": "C:/path/to/ymm4MCP/mcp-server/.venv/Scripts/python.exe", "args": ["C:/path/to/ymm4MCP/mcp-server/server.py"] } } }
プラグインは %LOCALAPPDATA%\YMM4MCP\connection.json に接続先と秘密トークンを書き込み、Python側は毎回これを読み取ります。このファイルを共有しないでください。接続確認には、YMM4を起動した状態で次を実行します(/api/status にもトークンが必要です)。
$connection = Get-Content "$env:LOCALAPPDATA\YMM4MCP\connection.json" -Raw | ConvertFrom-Json
Invoke-RestMethod -Uri "$($connection.api_base)/status" -Headers @{ 'X-Ymm4-Token' = $connection.token }
ポートはツール画面でサーバーを停止してから変更・保存し、再度起動します。Python側は更新された接続情報から新しいポートを自動取得します。手動で接続先を指定する場合だけ YMM4_API_BASE=http://127.0.0.1:<port>/api を設定してください。
📁 ファイル構成
自律編集 API の現状と次の実装順は API の優先順位 を参照してください。
ymm4プラグイン/
├── YMM4McpPlugin/ # YMM4に読み込まれるC#プラグイン
│ ├── YMM4McpPlugin.csproj
│ ├── McpToolPlugin.cs # IToolPlugin エントリーポイント
│ ├── McpHttpServer.cs # HTTPサーバー (port 8765)
│ ├── McpJobs.cs # ジョブ状態・cancel/resume
│ ├── McpExport.cs # 完成動画書き出し・プロジェクトopen/save-as
│ ├── McpPreview.cs # プレビュー撮影・録音・watch・クリップ書き出し
│ ├── McpReflectionApi.cs # 高度なReflection APIとコマンド探索
│ ├── McpDebugApi.cs # YMM4内部状態の診断ハンドラ
│ ├── McpEdits.cs # EditPlan状態・idempotencyバインディング・checkpoint
│ ├── McpKeyframes.cs # Animationキーフレーム
│ ├── McpEditing.cs # 安定ID・revision・素材追加
│ ├── 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
開発者向け:ビルドと配布
YMM4_PATH はソースからビルドするときにだけ必要です。YMM4のインストール先を指定してください。
$env:YMM4_PATH = "C:\path\to\YukkuriMovieMaker4"
dotnet build YMM4McpPlugin/YMM4McpPlugin.csproj -c Release -p:CreateYmme=true
# → artifacts\YMM4McpPlugin-1.5.0.ymme
From the project's README.