SuperCollider OSC MCP 🎛️
2025.04.17
0
Python音频合成音乐创作声音设计娱乐功能
SuperColliderMCP 是一个基于 Open Sound Control (OSC) 的 Model Context Protocol (MCP) 服务器，用于与 SuperCollider 进行通信。它提供了一个 Python 接口，允许从各种 AI 编码助手中程序化控制 SuperCollider 的音频合成和处理。该项目支持多种音频生成功能，包括旋律生成、节奏模式、高级声音设计、环境音景生成等，并可与多种 AI 开发环境集成。
View on GitHub
Overview
基本能力
产品定位
SuperColliderMCP 是一个用于音频合成和处理的 MCP 服务器，主要用于音乐创作、声音设计和 AI 辅助音频生成。
核心功能
- 发送 OSC 消息到 SuperCollider
- 播放不同音阶的程序生成旋律
- 创建节奏鼓模式
- 高级声音设计（合成器、效果器和调制）
- 环境音景生成
- 颗粒合成和分层乐器
- 和弦进行生成（不同声部风格）
- 与多种 AI 开发和辅助环境灵活集成
适用场景
- AI 辅助音乐创作
- 程序化音频生成
- 声音设计和实验音乐
- 环境音景和氛围音乐创作
工具列表
- play_example_osc - 播放带有频率调制的简单示例声音
- play_melody - 使用指定音阶和速度创建程序生成旋律
- create_drum_pattern - 播放不同风格的鼓模式
- play_synth - 使用不同合成器类型和效果播放单音符
- create_sequence - 从模式字符串创建带有音符长度变化的音乐序列
- create_lfo_modulation - 对合成器参数应用调制
- create_layered_synth - 创建具有多个失谐振荡器层和立体声扩展的丰富声音
- create_granular_texture - 使用颗粒合成创建纹理
- create_chord_progression - 播放不同声部风格的和弦进行
- create_ambient_soundscape - 生成具有不同情绪的环境音景
- create_generative_rhythm - 创建不同风格的演化节奏模式
常见问题解答
- 需要确保 SuperCollider 服务器在端口 57110 上运行
- 需要 Python 3.12 或更高版本
- 推荐使用 UV 作为 Python 包管理器
使用教程
使用依赖
- Python 3.12 或更高版本
- SuperCollider 3.13.1
- UV (Python 包管理器)
安装 UV 的命令:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
安装教程
# 克隆仓库
git clone https://github.com/tok/supercollidermcp.git
cd supercollidermcp
# 使用 UV 安装
uv pip install -e .
调试方式
# 测试功能
python -m mcp.run server.py
# 命令行界面示例
sc-osc note --freq 440 --amp 0.5 --duration 2.0
sc-osc scale --scale minor --tempo 100 --direction both
sc-osc melody --scale blues --tempo 120 --notes 16
sc-osc drums --pattern breakbeat --beats 32 --tempo 140