进度音效生成器

声音乐团MCP

轻量级的MCP服务器，将进度更新转化为友好的纯数据配乐。

快速开始

1. 安装Python deps：

pip install -r requirements.txt

2. 安装纯数据（pd）并确保 pd 在你的路径上。

   • 此补丁使用 mrpeach 用于OSC解析的Pd外部。安装 mrpeach （Pd包管理器）或确保 oscparse / routeOSC 在您的Pd安装中可用。

3. 运行服务器（从repo根目录）：

python src/main.py
# or
python -m uvicorn src.main:app --reload --port 2424

备注

• Pd必须在端口上接受OSC 4559 （Python服务器将消息发送到 127.0.0.1:4559).
• 语音/示例文件应放入 samples/ 目录（例如。 samples/voice_20.wav).服务器在触发采样时将绝对路径传递给Pd。
• lode/music-design.md 是音乐如何随着进步而发展的权威规范；没有明确的意图，不要改变它。

感兴趣的文件

• manifest.json --MCP公开的工具定义和模式。
• src/main.py --FastAPI端点和单一全局 PdOrchestra 例子
• src/pd_orchestra.py --OSC客户端和Pd子流程启动器；将打开 pd/orchestra.pd.
• pd/orchestra.pd --接收OSC并生成音频的纯数据补丁。

如果你愿意，我也可以：

• 为您的平台实施额外的Pd外部安装说明。
• 生成示例样本 .wav 文件或连接一个小的TTS脚本来生成 samples/voice_*.wav 提示。

验证器CLI

运行友好的验证器来练习OSC端点，并（可选）启动Pd。它将发送一些 /progress 更新和单次提示，以便您确认音频行为。

python src/verify.py
python src/verify.py --no-pd
python src/verify.py --pd "C:\\Program Files\\Pd\\pd.exe"

如果Pd可用并且补丁已加载，您应该在运行过程中听到温和的测试提示和提示。