Super Collider MCP


超级对撞机OSC MCP🎛️

使用开放式声音控制（OSC）的超级对撞机模型上下文协议（MCP）服务器。

描述

特性

• 向SuperCollider发送OSC消息
• 播放不同音阶的程序生成旋律
• 创建有节奏的鼓图案
• 先进的声音设计，包括合成器、效果和调制
• 环境声景生成
• 颗粒合成和分层仪器
• 不同发音风格的和弦推进生成
• 与多种人工智能开发和辅助环境灵活集成

创建可用工具时没有考虑到直接使用，因此范围可能有限。 它们旨在作为一个带有模板的代码库，以便您的AI代理在完全访问代码后进行进一步的定制和项目特定的实现。

安装

先决条件

• Python 3.12或更高版本
• 超级对撞机3.13.1

- 确保服务器在端口57110上运行

• 紫外线的 -快速Python包管理器

安装UV（Python包管理器）

# Install UV on macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install UV on Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

工程安装

# Clone the repository
git clone https://github.com/tok/supercollidermcp.git
cd supercollidermcp

# Install with UV
uv pip install -e .

用法

AI开发环境集成

克劳德桌面

在Claude Desktop设置中配置：

"Super-Collider-OSC-MCP": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli],python-osc",
    "mcp",
    "run",
    "path/to/server.py"
  ]
}

Roo代码/临床

增添 mcp.json:

{
  "mcpServers": {
    "Super-Collider-OSC-MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli],python-osc",
        "mcp",
        "run",
        "path/to/server.py"
      ]
    }
  }
}

AI助手工具适配

动态工具创建的工作空间集成

要启用高级功能，建议添加 server.py AI助手的工作空间。这使得AI能够：

• 动态了解项目的结构
• 分析和修改现有的声音生成工具
• 根据需要创建新的基于OSC的工具
• 调整Python代码以扩展功能

集成步骤

1. 将整个项目目录添加到AI助手的工作区
2. 确保 server.py AI可见且可访问
3. 提供有关MCP和OSC通信协议的上下文
4. 允许AI检查和修改项目文件

推荐的工作空间结构

supercollidermcp/
│
├── server.py              # Main MCP server with all sound generation tools including advanced synthesis, soundscape and generative rhythm tools
├── supercollidermcp/
│   ├── osc.py             # SuperCollider OSC client
│   ├── melody.py          # Melody generation utilities
│   ├── rhythm.py          # Rhythm pattern utilities
│   └── ...
└── README.md

注： 动态修改工具的能力取决于AI助手的特定功能及其与模型上下文协议的集成。

本地测试和开发

该项目已使用Claude Desktop进行了测试，并在本地使用Roo Code进行了测试：

• 奥拉马 -本地AI模型服务器
• DeepCoder （开源模式）

可用命令

配置后，助手可以使用各种工具：

基本声音生成

1. play_example.osc -播放一个简单的调频声音示例
2. play_mlody -使用指定的音阶和节奏创建程序生成的旋律
3. create_drum_pattern -播放各种风格的鼓图案（四首落地、霹雳、洗牌、随机）
4. play_synth -用不同的合成器类型（正弦、锯齿、方形、噪声、调频、垫）和效果播放单个音符
5. 创建序列 -从具有音符长度变化的模式字符串创建音乐序列

高级合成

1. create_lfo_调制 -对合成器参数（频率、振幅、滤波器、摇摄）应用调制
2. create_layered_synth -使用多个失谐振荡器层和立体声扩展创建丰富的声音
3. 创建纹理 -使用具有可控密度和间距变化的粒度合成创建纹理
4. 创建_缩短_进程 -用不同的发音风格（拨片、断奏、琶音、力量）演奏和弦进行曲

声景生成

1. create_ambient_soundscape -生成具有不同情绪（平静、黑暗、明亮、神秘、混乱）的不断变化的环境纹理
2. create_generative_rythm -以不同风格（极简、电子、小故障、爵士、环境）创造不断发展的节奏模式

Claude中的示例用法

以下是在Claude中如何使用这些工具的一些示例：

// Basic melody
play_melody(scale="pentatonic", tempo=110)

// Layered synth with effects
create_layered_synth(base_note="F3", num_layers=4, detune=0.2, effects={"reverb": 0.6, "delay": 0.3}, duration=4.0)

// Ambient soundscape
create_ambient_soundscape(duration=20, density=0.6, pitch_range="medium", mood="mysterious")

// Chord progression
create_chord_progression(progression="Cmaj7-Am7-Dm7-G7", style="arpeggio", tempo=100, duration_per_chord=2.0)

本地测试

您可以通过运行以下命令直接测试功能：

python -m mcp.run server.py

您还可以使用命令行界面：

# Play a note
sc-osc note --freq 440 --amp 0.5 --duration 2.0

# Play a scale
sc-osc scale --scale minor --tempo 100 --direction both

# Generate and play a melody
sc-osc melody --scale blues --tempo 120 --notes 16

# Play a drum pattern
sc-osc drums --pattern breakbeat --beats 32 --tempo 140

关于SuperCollider

超级对撞机 是一个用于音频合成和算法作曲的平台，供音乐家、艺术家和研究声音的研究人员使用。它包括：

• 具有数百个用于合成和信号处理的单元生成器的实时音频服务器
• 一种跨平台的解释性编程语言（sclang）
• 一种用于音乐事件精确计时的灵活调度系统

该项目使用OSC消息与SuperCollider的音频服务器通信，以控制合成器并创建声音模式。

外部安全评估

](https://mseep.ai/app/tok-supercollidermcp)

发展

该项目使用FastMCP处理Claude的请求，并使用python osc库与SuperCollider通信。有关模型上下文协议的更多信息，请访问 https://modelcontextprotocol.io/.

贡献

欢迎投稿！请提交拉取请求：

• 新的声音生成工具
• 改进的集成方法
• Bug修复和优化

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

额外资源

• 模型上下文协议
• SuperCollider官方网站