SongForge-MCP

<h1 align="center">SongForge-MCP</h1> <p align="center"> <strong>通过Claude生成原创AI音乐，由ACE-Step 1.5驱动</strong> </p> <p align="center"> <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python 3.10+" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green.svg" alt="License" /></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple.svg" alt="MCP Compatible" /></a> <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.2.0-orange.svg" alt="v0.2.0" /></a> <a href="https://github.com/xDarkzx/SongForge-MCP/actions/workflows/ci.yml"><img src="https://github.com/xDarkzx/SongForge-MCP/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="https://github.com/ace-step/ACE-Step-1.5"><img src="https://img.shields.io/badge/GPU-12GB%2B%20VRAM-red.svg" alt="GPU 12GB+ VRAM" /></a> </p> <p align="center"> <a href="#quick-start">快速开始</a> &bull; <a href="#features">功能</a> &bull; <a href="docs/TOOLS.md">工具参考</a> &bull; <a href="docs/ARCHITECTURE.md">架构</a> &bull; <a href="CHANGELOG.md">更新日志</a> &bull; <a href="CONTRIBUTING.md">贡献</a> &bull; <a href="docs/INSTALLATION.md#troubleshooting">故障排除</a> </p> --- **用简单的英文向Claude请求一首歌——例如“一首关于公路旅行的欢快流行歌曲，歌词关于自由”——然后获得一个真正的、完整的音频文件。** 不需要音乐软件，不需要AI/ML知识，也不需要账户或订阅。所有操作都在您自己的计算机上运行。 ## 这是什么？ 这是一个 **MCP服务器** —— 一个小型本地程序，它为Claude Desktop（Anthropic的Claude应用）提供了一个新功能：生成实际的音乐。“MCP”（模型上下文协议）只是Claude应用插件额外工具的标准方式；您不需要理解它就可以使用它，只需要安装一次（见下文）。 在底层，该服务器驱动 [ACE-Step 1.5](https://github.com/ace-step/ACE-Step-1.5) —— 一个真正有能力的、开源的AI音乐生成模型，完全归原作者所有；该项目不训练或拥有任何模型，只是自动化使用它。ACE-Step自己的接口暴露了大约70个相互依赖的生成设置，获得好的结果取决于许多不明显的默认值和它们之间的交互。SongForge-MCP完全删除了这一层：您用对话描述要跟踪的歌曲，Claude调用该服务器生成它，正确处理您所有的底层设置。您永远不会触摸设置面板。 ## 完全在您自己的机器上运行 没有云服务，没有订阅，也不需要创建账户。生成发生在您自己的GPU上，使用一次下载到您自己的磁盘上的模型。您的提示、歌词和生成的音频永远不会被发送到任何第三方服务器进行处理，您的使用情况也不会被记录或传输到任何地方。只有一个例外是严格选择加入的：如果您将生成指向YouTube链接以进行参考音频样式匹配，则该特定请求自然会到达YouTube以获取音频——此服务器上的其他内容都不会进行任何网络调用。所有内容，包括每次生成，都完全本地化。 ## 功能 - **`generate_vocal_track`** — 从样式描述和完整歌词中生成完整的原创曲目（包括人声和乐器），可以根据您要求的类型和情绪生成。 - **`split_vocal_stems`** — 将生成的曲目分离成孤立的人声干和孤立的乐器干，以便将人声放入您自己的作品中，而不是直接使用。 - **参考音频样式匹配** — 将生成指向特定的声乐样本或YouTube链接，结果采用该声音的音色和表演特征。它不会复制参考的旋律、节奏或歌词——这些仍然完全来自您要求Claude编写的内容。 - **防护措施，而不是猜测。** 此服务器不明确需要的每个设置都保留在ACE-Step自己的已证明正确的默认值中，而不是通过猜测重建——这种方法在其他方法无声地产生噪音后产生了可靠的结果。 为极少数情况提供`advanced_settings`覆盖，其中特定的ACE-Step设置确实需要更改。 ## 快速开始 **推荐硬件：** 具有 **≥12GB VRAM** 的NVIDIA GPU（≥20GB无CPU卸载），以及 **~40GB可用磁盘空间** 用于此服务器配置为使用的ACE-Step 1.5 XL-SFT模型。参见安装文档中的 [系统要求](docs/INSTALLATION.md#system-requirements) 以获取完整说明（包括在低VRAM或无GPU机器上会发生什么）——这些数字来自ACE-Step 1.5自己的发布要求，而不是猜测。 1. 运行`install.bat`（Windows）或`install.sh`（Linux/macOS）——参见 [`docs/INSTALLATION.md`](docs/INSTALLATION.md) 以了解每个步骤的具体操作以及如果某个步骤失败该怎么办。它会一次性完成所有设置，包括在Windows上安装Python（如果系统上没有Python）。 2. 安装程序会自动为您配置Claude Desktop——请说是，并重启Claude Desktop。如果您想手动配置（或使用不同的MCP客户端），请参见 `docs/INSTALLATION.md`。 3. 用简单的语言请求一首歌曲。参见 [`docs/TOOLS.md`](docs/TOOLS.md) 以获取完整的工具参考和示例请求。 ## 与Reaper-MCP配合良好 如果您的制作工作流程是围绕REAPER构建的，那么此服务器生成的声乐和乐器干非常适合使用[Reaper-MCP](https://github.com/xDarkzx/Reaper-MCP)直接导入REAPER项目，Reaper-MCP是用于REAPER中AI辅助作曲、混音和母带制作的配套MCP服务器。两个服务器都可以连接到同一个Claude Desktop会话，允许在这里生成曲目，然后在不离开对话的情况下将其放置、安排和进一步制作。 ## 文档 - [`docs/INSTALLATION.md`](docs/INSTALLATION.md) — 分步安装和配置。 - [`docs/TOOLS.md`](docs/TOOLS.md) — 每个工具的作用以及如何请求您想要的内容。 - [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — 此服务器如何在底层驱动ACE-Step，供维护或扩展的人员参考。 ## 状态 已针对ACE-Step 1.5实例实施并验证端到端。人声/乐器分离功能但不完美——当前分离模型的某些泄漏是已知限制，而不是此服务器中的错误。