VOCALOID6 MCP 服务器

让 AI（通过 MCP 协议，在 atomcode 客户端中调用）自动作曲并驱动本机 VOCALOID6 编辑器， 产出可渲染歌声的工程文件（.vpr / .vsqx）。

用户输入歌词/想法
   ↓
[MCP 工具] list_voicebanks  → 查看本机可用歌姬（MIKU_V4X 系列等）
   ↓
[MCP 工具] compose_song    → 歌词+歌姬+情感+歌曲结构 → 旋律 MIDI → .vpr 工程
   ↓
[MCP 工具] midi_to_vocaloid → 已有 MIDI + 歌词 → .vpr 工程
   ↓
[MCP 工具] open_in_vocaloid6 → 自动打开 VOCALOID6 编辑器
   ↓
[MCP 工具] render_wav      → UI 自动化渲染导出 WAV（尽力实现，失败给手动兜底）
   ↓
得到歌声 WAV

方案定位

• 方案 A：AI 产出 VPR/VSQX 工程文件 + 自动打开编辑器，你点一下渲染。零脆弱点。

• 方案 B：pywinauto UI 自动化自动渲染 WAV（render_wav，尽力实现，失败时返回明确错误与手动步骤）。

Related MCP server: flai-mcp

安装

cd C:/Users/Admin/vocaloid6-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

启动 MCP 服务器

python server.py

接入 atomcode 的 MCP 配置后（C:/Users/Admin/.atomcode/mcp.json 已指向本项目），AI 即可调用以下工具：

完整写歌示例（AI 调用链）

1. list_voicebanks → 找到 MIKU_V4X_Original_EVEC

2. lyric_correct("我爱月光照亮黑夜", lang="zh") → 预检中文拼音

3. compose_song(lyrics="我爱月光照亮黑夜", voice="MIKU_V4X_Original_EVEC", emotion="sad", structure="pop", key="Am", scale="minor") → 生成 .vpr/.vsqx

4. open_in_vocaloid6(vpr_path) → 打开编辑器试听

5. render_wav(vpr_path, output_wav="out.wav") → 尝试自动渲染 WAV

参数速查

• voice 歌姬：list_voicebanks 返回的 name 或 comp_id；中文用户常用 MIKU_V4X_Original_EVEC（初音未来）

• emotion 情感：happy/sad/gentle/passionate/rock/calm（或中文：快乐/悲伤/温柔/激昂/摇滚/平静），控制力度/开音/颤音/音域和 Part 控制器曲线

• structure 结构：pop / simple / ballad（和弦进行 + 主歌/副歌/桥段/尾声）

• key 调性：C / Dm / Eb / F#m 或数字 0-11

• scale 音阶：major / minor / pentatonic / minor_penta

目录结构

vocaloid6-mcp/
├── server.py          # MCP 服务器入口（注册 7 个工具）
├── requirements.txt   # 独立依赖（含 pywinauto）
└── v6mcp/
    ├── __init__.py
    ├── lyrics.py      # 日文假名/片假名 → 音素 + 中文拼音
    ├── emotion.py     # 情感 → 表现力参数映射（DYN/BRI/CLE/GEN/OPE/颤音）
    ├── midi2vpr.py    # MIDI → VPR/VSQX 工程生成 + 声库发现/歌姬选择
    ├── compose.py     # 旋律生成（和弦进行 + 歌曲结构）+ 混合改编
    └── vocaloid6.py   # 编辑器定位/打开 + render_wav UI 自动化

状态

• 方案设计文档（docs/vocaloid6-mcp-design.md）

• 阶段 0：依赖与骨架

• 阶段 1：midi_to_vocaloid + open_in_vocaloid6（方案 A）

• 阶段 2：compose_song 作曲编排（歌姬/情感/歌曲结构）

• 阶段 3：mix_songs 混合改编

• 阶段 4：render_wav UI 自动化（方案 B，尽力实现）

• 阶段 5：接入 atomcode MCP（mcp.json 指向本项目）