ymm4MCPCAUTION
ゆっくりムービーメーカー4のMCPです。将来的にはゆっくり動画を全自動で作れるようにしたいです。
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
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 -
5b78463d7329OBSERVED · 2026-10-10Exposed tools (1)
1 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
ymm4_preview | read | YMM4のプレビュー映像・音声を認識するツール。capture=現在フレームを画像取得、seek_capture=指定フレームに移動して画像取得、position=再生位置取得、record=システム音声録音(ループバック) |
Trust audit
CAUTIONgrade C · trust 75/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (8 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (22)
project_type_info.json
project_type_info_v2.json
props_debug.json
props_dump.json
public string BaseUrl => $"http://127.0.0.1:{Port}/";YMM4_API_BASE = "http://127.0.0.1:8765/api"
$entry.env = @{ YMM4_API_BASE = "http://127.0.0.1:$Port/api" }{{[
TOKEN = "test-only-not-for-production-0123456789"
filtered_props.txt
ポートはツール画面でサーバーを停止してから変更・保存し、再度起動します。Python側は更新された接続情報から新しいポートを自動取得します。手動で接続先を指定する場合だけ `YMM4_API_BASE=http://127.0.0.1:<port>/api` を設定してください。
"http://127.0.0.1:8765/api", {"X-Ymm4-Token": "secret"})), \wav_bytes = base64.b64decode(audio_b64, validate=True)
wav_bytes = base64.b64decode(audio_b64, validate=True)
raw = base64.b64decode(image_b64, validate=True)
img_data = base64.b64decode(data["image"])
img_data = base64.b64decode(data["image"])
mcp, httpx, google-genai, starlette, uvicorn, Pillow
Gates applied: no_behavioural_pass, no_license.
5b78463d7329full audit observations/trust-audit/mcp-server/scpgamerscp__ymm4mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-10 | 5b78463d7329 | CAUTION | C | 75 | first audit |
Questions
What is the ymm4MCP MCP server?
ゆっくりムービーメーカー4のMCPです。将来的にはゆっくり動画を全自動で作れるようにしたいです。
What tools does ymm4MCP expose?
1 in total: 1 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is ymm4MCP safe to connect to an agent?
With care. The audit graded it C (75/100) and found 22 things worth knowing before you trust this server, listed below with the exact line each was found on.
What credentials does ymm4MCP need?
It reads GEMINI_API_KEY, GOOGLE_API_KEY, YMM4_API_TOKEN and YMM4_MCP_BEARER_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does ymm4MCP run?
It speaks stdio and streamable-http, so it runs as a local process your client starts.
How current is this page?
The grade is for one exact copy of the source (5b78463d7329), read on 2026-10-10. The repository is watched and re-audited when it changes.