SuperColliderMCP

SuperCollider OSC MCP 🎛️

A Model Context Protocol (MCP) server for SuperCollider using Open Sound Control (OSC).

Description

This project provides a Python interface for communicating with SuperCollider via OSC messages, integrated with AI development environments using the Model Context Protocol (MCP). It allows for programmatic control of audio synthesis and processing in SuperCollider from various AI coding assistants.

Features

• Send OSC messages to SuperCollider
• Play procedurally generated melodies with different scales
• Create rhythmic drum patterns
• Advanced sound design with synthesizers, effects, and modulation
• Ambient soundscape generation
• Granular synthesis and layered instruments
• Chord progression generation with different voicing styles
• Flexible integration with multiple AI development- and assistance environments

Installation

Prerequisites

• Python 3.12 or higher
• SuperCollider 3.13.1
• UV - Fast Python package manager

AI Assistant Tool Adaptation

• Add the entire project directory to the AI assistant's workspace
• Allow the AI to inspect and modify the project files

Available Commands

1. play_example_osc - Play a simple example sound with frequency modulation
2. play_melody - Procedure generated melody
3. create_drum_pattern - Play drum patterns in various styles
4. play_synth - Play a note with different synthesizer types
5. create_sequence - Create a musical sequence
6. create_lfo_modulation - Apply modulation to synthesizer parameters
7. create_layered_synth - Create rich sounds with multiple layers
8. create_granular_texture - Granular synthesis with controllable parameters
9. create_chord_progression - Play chord progressions in various styles
10. create_ambient_soundscape - Generate evolving ambient textures
11. create_generative_rhythm - Create evolving rhythmic patterns

Testing Locally

Run python -m mcp.run server.py to test functionality.