Ymm4 MCP

YMM4MCP插件

一种插件，允许从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 | 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（操作系）

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（镜像・音声确认系）

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个字符/秒进行影像确认的同时生成台词。有适合游戏活动的模板 | 慢慢地解说 | ymm4-kaisetsu/SKILL.md 魔理沙解说灵梦提问。点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以后（支持.NET9/.NET10）｜ 因为图像+声音数据大，所以最大推荐8秒左右 第一次捕获后的第一张可能会变黑（等待绘制）。正常动作｜ ｜端口冲突｜8765冲突时 McpHttpServer.cs 的，之 Port 更改 | 内部API | IMainViewModel 的实现可能因YMM4版本而异