星战科技xingzhan.cloud
返回市场
超导体MCP

超导体MCP

作者：Tok10 星标更新：2025-05-15
安装使用来源：spider==github.com

项目介绍

在MseeP上验证

SuperCollider OSC MCP 🎛️

这是一个使用开放声音控制（OSC）与SuperCollider通信的模型上下文协议（MCP）服务器。

描述

该项目提供了一个Python接口，用于通过OSC消息与SuperCollider进行通信，并与使用模型上下文协议（MCP）的人工智能开发环境集成。它允许从各种人工智能编码助手对SuperCollider中的音频合成和处理进行编程控制。

特性

  • 向SuperCollider发送OSC消息
  • 演奏不同音阶生成的旋律
  • 创建节奏鼓模式
  • 使用合成器、效果和调制进行高级声音设计
  • 环境声音景观生成
  • 颗粒合成和分层乐器
  • 不同声部风格的和弦进程生成
  • 与多个AI开发和辅助环境灵活集成

可用工具并非旨在直接使用，因此可能范围有限。 它们旨在作为代码库，供您的AI代理在获得完整代码访问权限后进一步定制和项目特定实现。

安装

先决条件

  • Python 3.12或更高版本
  • SuperCollider 3.13.1
    • 确保服务器运行在端口57110上
  • UV - 快速Python包管理器

安装UV（Python包管理器）

# 在macOS/Linux上安装UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 在Windows上安装UV
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 .

使用

AI开发环境集成

Claude Desktop

在Claude Desktop设置中配置：

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

Roo Code / Cline

添加到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              # 包含所有声音生成工具的主要MCP服务器，包括高级合成、声音景观和生成节奏工具
├── supercollidermcp/
│   ├── osc.py             # SuperCollider OSC客户端
│   ├── melody.py          # 旋律生成实用程序
│   ├── rhythm.py          # 节奏模式实用程序
│   └── ...
└── README.md

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

本地测试和开发

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

可用命令

一旦配置完成，助手可以使用多种工具：

基本声音生成

  1. play_example_osc - 播放一个简单的示例声音，带有频率调制
  2. play_melody - 使用指定的音阶和速度生成旋律
  3. create_drum_pattern - 播放不同风格的鼓模式（四拍、断拍、摇摆、随机）
  4. play_synth - 使用不同的合成器类型（正弦波、锯齿波、方波、噪声、FM、垫）和效果播放单个音符
  5. create_sequence - 从模式字符串创建音乐序列，具有不同的音符长度变化

高级合成

  1. create_lfo_modulation - 对合成器参数（频率、幅度、滤波器、立体声）应用调制
  2. create_layered_synth - 使用多个失谐振荡器层和立体声扩散创建丰富的声音
  3. create_granular_texture - 使用可控密度和音高变化的颗粒合成创建纹理
  4. create_chord_progression - 使用不同的声部风格（垫、断奏、琶音、强力）播放和弦进程

声音景观生成

  1. create_ambient_soundscape - 生成不同情绪（平静、黑暗、明亮、神秘、混乱）的演变环境纹理
  2. create_generative_rhythm - 在不同风格（极简、电子、故障、爵士、环境）下生成演变节奏模式

在Claude中的示例用法

这里有一些如何在Claude中使用这些工具的例子：

// 基本旋律
play_melody(scale="pentatonic", tempo=110)

// 带有效果的分层合成器
create_layered_synth(base_note="F3", num_layers=4, detune=0.2, effects={"reverb": 0.6, "delay": 0.3}, duration=4.0)

// 环境声音景观
create_ambient_soundscape(duration=20, density=0.6, pitch_range="medium", mood="mysterious")

// 和弦进程
create_chord_progression(progression="Cmaj7-Am7-Dm7-G7", style="arpeggio", tempo=100, duration_per_chord=2.0)

本地测试

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

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

关于SuperCollider

SuperCollider 是一个用于音频合成和算法作曲的平台，被音乐家、艺术家和从事声音研究的研究人员使用。它由以下部分组成：

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

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

外部安全评估

MseeP.ai 安全评估徽章

开发

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

贡献

欢迎贡献！请提交拉取请求，包含：

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

许可证

本项目根据MIT许可证发布 - 详情见LICENSE文件。

额外资源