AI-VOCALOID-MCP

让 AI 通过自然语言生成、编辑和导出 VOCALOID 工程文件 (.vpr/.vsqx) 的 MCP 服务器。

让 AI 直接创作 VOCALOID 歌曲的 MCP 服务器（Python 实现） 通过自然语言生成、编辑和导出 VOCALOID 工程文件 (.vpr / .vsqx)，无缝对接支持 MCP 的 AI 助手（如 Claude Desktop、Continue 等）。

✨ 功能特性

• 🎵 AI 生成歌曲 —— 通过提示词（歌词、风格、节奏）自动创建完整的 VOCALOID 工程
• ✍️ 编辑音符/歌词 —— 修改已有工程的旋律、歌词、表情参数
• 🎚️ 调整音乐参数 —— 设置速度（BPM）、拍号、调号等全局信息
• 💾 导出工程文件 —— 生成 .vpr（VOCALOID 5/6）或 .vsqx（VOCALOID 3/4）文件
• 🔍 工程解析 —— 读取现有工程并输出结构化数据供 AI 分析
• 🧩 零外部依赖 —— 纯 Python 标准库 (json, zipfile, dataclasses)

📦 依赖

零外部依赖。Python 3.10+。

🔧 项目结构

ai-vocaloid-mcp/
├── vpr_sdk/                  # VPR 工程 SDK
│   ├── models.py             #   24 个 dataclass，JSON ↔ Python
│   ├── io.py                 #   ZIP 读写 + JSON 序列化
│   ├── project.py            #   VPRProjectWrapper + Helper API
│   └── README.md             #   API 文档 & 字段速查
├── main.py                   # MCP 服务器入口
├── pyproject.toml
└── README.md

vpr_sdk 是底层库，提供解析、创建、编辑 VPR 工程的完整能力。MCP 服务器在 main.py 中调用 vpr_sdk 完成工具注册。

详见 vpr_sdk/README.md

🚀 使用示例（与 AI 对话）

在 Claude Desktop 中启动后，你可以这样与 AI 对话：

用户：帮我写一首 90 BPM 的 C 大调歌曲，用初音未来唱，歌词是"Hello world, this is a test"。保存为 hello.vpr。

AI 会调用 create_song + export_project 工具，然后返回文件的保存路径。

用户：把第三轨道的第二个音符的歌词改成"love"，音高上升一个半音。

AI 调用 edit_note 完成修改。

📄 许可证

MIT

🙏 致谢

• Model Context Protocol – 使 AI 集成变得标准而优雅
• VOCALOID 社区的所有创作者

💬 反馈与贡献

欢迎提 Issue 或 PR。