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.设置环境变量```powershell
### 2.构建YMM4插件```powershell
cd YMM4McpPlugin
dotnet build -c Release
# → %YMM4_PATH%\user\plugin\YMM4McpPlugin\YMM4McpPlugin.dll に自動コピー
调试时手动部署:```powershell
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服务器设置```bash
cd mcp-server
pip install -r requirements.txt
4.Claude Desktop的设置
%APPDATA%\Claude\claude_desktop_config.json 添加到:```json
{
"mcpServers": {
"ymm4": {
"command": "python",
"args": ["C:/Users/ecrea/OneDrive/デスクトップ/ymm4プラグイン/mcp-server/server.py"]
}
}
}
### 5.在YMM4上启动服务器
1. 启动YMM4
1. 工具菜单→打开“MCP协作服务器”
1. **「▶ 起动」** 按钮关闭对话框
1. `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`(操作系)
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参数:**```python
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(镜像・音声确认系)
| capture 取得当前帧PNG
| seek_capture 移动到指定帧并获取PNG
| position 获取当前播放位置
| record 只录制声音(保存WAV)
| watch 视频捕捉+音频录音同时执行★
watch参数:```python
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版本而异
