声音乐团MCP
轻量级的MCP服务器,将进度更新转化为友好的纯数据配乐。
快速开始
- 安装Python deps:
pip install -r requirements.txt- 安装纯数据(pd)并确保
pd在你的路径上。
- 此补丁使用 mrpeach 用于OSC解析的Pd外部。安装 mrpeach (Pd包管理器)或确保 oscparse / routeOSC 在您的Pd安装中可用。
- 运行服务器(从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可用并且补丁已加载,您应该在运行过程中听到温和的测试提示和提示。
