Ymm4MCP

ゆっくりムービーメーカー4のMCPです。将来的にはゆっくり動画を全自動で作れるようにしたいです。

LLM Mart 3 views 50 listing impressions

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

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

🚀 はじめに(Windows)

  1. Releases から最新版の YMM4McpPlugin-*.ymme をダウンロードします。YMM4を閉じて .ymme をダブルクリックし、YMM4の案内に従ってインストールします。利用者は YMM4_PATH や .NET SDK を設定する必要はありません。

  2. YMM4を起動します。新規インストールではプラグインのHTTPサーバーが自動起動します。「ツール」→「MCP連携サーバー」で状態を確認できます。既に自動起動を無効にしている場合は、この画面の「▶ 起動」を押します。

  3. 同じ 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 と接続確認に反映します。省略時は接続ファイルの設定を使います。

  4. 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.

Related servers

Read and write RAGE Package Format archives

23 views

See how ChatGPT, Claude, Gemini and Perplexity read any website. Scored out of 100.

19 views

MCP server for Geargrafx PC Engine / TurboGrafx-16 emulator

19 views

Read-only on-chain intel for AI agents on Base: balances, tokens, gas, tx status. No API keys.

15 views