内容
# MMD MCP
为 MikuMikuDance (MMD) 添加 MCP (Model Context Protocol) 服务器功能的插件。使用 MMDPlugin (v0.41 x64)。
## 使用方法
### 1. 安装 MMDPlugin
MMD 需要 MMDPlugin 来添加插件机制。
请使用 [MMD Plugin Install Manager (PTOM76 fork)](https://github.com/PTOM76/MMDPluginInstallManager) 进行安装。
### 2. 编译和放置 mmd_mcp.dll
按照下面的“编译”部分编译 `mmd_mcp.dll`，并在 MMD 的 `Plugin/` 目录中创建一个子文件夹来放置它。
```
MikuMikuDance/
Plugin/
mmd_mcp/
mmd_mcp.dll
```
### 3. 启动 MMD
启动 MMD 后，插件将自动加载，MCP 服务器将在 `http://127.0.0.1:3939` 处开始监听。
### 4. 配置 MCP 客户端
使用 Claude Code 执行以下命令来注册 MCP 服务器。
```bash
claude mcp add mmd --transport streamable-http http://127.0.0.1:3939/mcp
```
使用其他 MCP 客户端时，请将 `http://127.0.0.1:3939/mcp` 设置为 Streamable HTTP 端点。
> **注意:** MMD 未启动时无法连接。请务必先启动 MMD，然后再使用 Claude Code。
> **警告:** 此插件正在开发中，直接操作 MMD 内存。项目文件（.pmm）或模型文件（.pmx）请务必备份后使用。
## 依赖
- CMake 4.1+
- MSVC (C++20)
- [DirectX SDK (June 2010)](https://www.microsoft.com/en-us/download/details.aspx?id=6812) — 如果不是默认路径，请设置环境变量 `DXSDK_DIR`
## 编译
```bash
cmake --preset default
cmake --build build
```
输出：`build/Debug/mmd_mcp.dll`，放置在 MMD 的 `Plugin/mmd_mcp/` 目录中。
## 部署
在 `CMakeUserPresets.json` 中设置 `MMD_PLUGIN_DIR`:
```json
{
"version": 6,
"configurePresets": [
{
"name": "local",
"inherits": "default",
"cacheVariables": {
"MMD_PLUGIN_DIR": "path/to/MikuMikuDance/Plugin/mmd_mcp"
}
}
]
}
```
配置并部署：
```bash
cmake --preset local
cmake --build build --target deploy
```
