mmd-mcp：在 Windows 上用 MCP 驅動 MikuMikuDance 製作與 MME 設定

mmd-mcp 是一個面向 Windows 的 stdio MCP 伺服器，用於控制 MikuMikuDance（MMD）的作者化操作與 MME 特效設定。適合它的前提很明確：你必須在 Windows 上、已自行啟動 MMD 9.32 x64（日文發行版，伺服器會拒絕不支援的版本），並願意完成原始碼編譯安裝（需要 Python x64 和 Visual Studio 2022/Build Tools 的 C++ 桌面開發元件）。它不會自動啟動 MMD，也不監聽網路。如果你的環境不滿足這些條件，或者不想動編譯工具鏈，它不適合作為首選。

適合誰

• 在 Windows 上做 MMD 動畫製作的人，需要透過程式化方式調整模型、相機、燈光、物理、時間軸，或編輯 MME 的 EMM 特效分配、輸出 AVI 影片。
• 驗證環境為日文發行版 MMD 9.32 x64、日文 Windows、Python 3.10 x64；使用其他 MMD 版本會被拒絕，因此其他版本使用者應視為不受支援。
• 不適合：macOS/Linux 使用者、尚未安裝 MMD 或使用非驗證版本的人、不想裝 Visual Studio C++ 元件的人。官方證據未提及 macOS/Linux 支援，這一點未知。

3 分鐘完成第一次嘗試

注意：這條主路徑不是 3 分鐘就能跑完的，原始碼編譯 DLL 需要較長時間；「3 分鐘」指的是步驟數量少。

前提：

1. Windows 環境，已安裝 Python x64（驗證環境為 3.10 x64）。
2. 已安裝 Visual Studio 2022 或 Build Tools，並勾選 C++ 桌面開發元件（用於編譯原生 DLL）。
3. 已啟動日文版 MMD 9.32 x64——伺服器不會自動啟動 MMD。

安裝（在儲存庫目錄下，官方給出的 PowerShell 命令）：

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .
cmd /c scripts\build_native.cmd

第三條命令會編譯原生 DLL，這是必須步驟，編譯產物落在本地。

註冊到 MCP 用戶端（stdio 方式），官方範例設定：

"command": "C:/Tools/mmd-mcp/.venv/Scripts/python.exe",
"args": ["-m", "mmd_mcp.server"]

路徑需替換為你自己的 venv 位置。

第一次呼叫建議用 mmd_list_windows：它只列出視窗，不更動場景，是最低風險的首次呼叫。成功訊號是回傳目前 MMD 視窗清單及其 hwnd。如果啟動了多個 MMD 實例，後續每次呼叫都需要把 mmd_list_windows 回傳的 hwnd 傳入。官方未說明 mmd_list_windows 是否標註為唯讀提示（readOnlyHint），不要把任何工具當作零風險。

其他安裝方式：官方僅給出上述原始碼安裝路徑，未提供 pip 安裝套件或預編譯二進位檔的說明。

使用案例

案例一：確認連線與多實例管理。場景：你剛設定好用戶端，想確認它能找到 MMD。呼叫 mmd_list_windows，觀察回傳的視窗清單與 hwnd。若只開了一個 MMD，之後可直接呼叫其他工具；若開了多個 MMD，按官方說明把對應 hwnd 傳給每次呼叫以指定目標。可確認到這一步：視窗列舉與 hwnd 傳遞機制，更細的輸出格式以實際回傳為準。

案例二：批次寫入相機關鍵影格並匯出影片。場景：你做好了一段動作，想程式化設定相機運鏡並輸出 AVI。官方 v0.3.0 提供 50 個工具，其中 mmd_batch_camera_keys 可批次寫入相機關鍵影格，mmd_export_video 可輸出 AVI。注意這兩個都是對目前 MMD 專案的寫入操作：關鍵影格寫入和影片匯出會改變/產生專案內容，呼叫前應確認目前開啟的專案可被修改或已有備份。官方證據未說明這些工具是否有復原路徑，也未說明匯出參數細節，呼叫前請在用戶端裡核對具體參數定義。

使用邊界

• 讀寫性質：50 個工具中既有視窗/場景查詢類呼叫，也有模型選擇、骨骼/相機關鍵影格批次寫入、EMM 特效分配讀寫（mmd_read_effect_assignments / mmd_write_effect_assignments）、AVI 匯出等寫入操作。寫入操作直接作用於你已開啟的 MMD 專案。
• 環境綁定：驗證環境限定 MMD 9.32 x64（日文發行版，官方按特定 SHA-256 校驗），不支援的組建會被拒絕。
• 前提與副作用：必須預先手動啟動 MMD；伺服器不自動啟動 MMD、不監聽網路；多實例時必須傳 hwnd 指定目標，否則目標不明確。
• 本地寫入：安裝過程會在本地建立 venv 並編譯原生 DLL，這是必需的本地改動。
• 未確認項：官方證據未說明工具是否提供復原機制、各寫入操作的參數細節、以及中文/英文 Windows 或其他 Python 版本的相容性。這些資訊缺失不等於沒有風險，使用寫入操作前請自行備份專案。