SuperCollider — Claude Code MCP server: what it does, how to install
SuperCollider — an MCP server for Claude Code bridges the model to the scsynth audio engine. It sequences synthesizer voices, drum loops, chords, and ambient textures using OSC messages.
MIT ★ 28 updated 2026-11-06
claude mcp add --env SC_HOST=<SC_HOST> --env SC_PORT=<SC_PORT> --transport stdio supercollider -- uvx supercollider-mcpWhat SuperCollider does
The server converts assistant actions into timestamped event bundles for scsynth. It contains built-in SynthDef graphs covering sine, saw, FM, noise, pads, plucked tones, and drum elements. Nothing relies on default sclang patches or optional sc3-plugins packages. An output safety limiter protects levels, and an auxiliary bus handles filtering, delay, saturation, and reverb.
Events flow as NTP-tagged UDP bundles to port 57110. Tools return right away without pausing, which lets the model stack rhythms, progressions, and leads concurrently. If volume runs runaway, calling stop_all cancels every running voice created by this bridge.
The server requires an active scsynth instance from SuperCollider 3.10 or newer. Running the package needs Python 3.10+ or the uv CLI tool.
What it helps with
- generate synth parts and sequences directly from the chat prompt
- build multi-track drum grooves with accents and custom swing
- layer live modulation and ambient drones in real time
- mute all running synthesis processes instantly
Example prompts for the agent
- Generate a drum pattern at 140 tempo alongside a pluck arpeggio
- Build an evolving drone texture using the pad synth with heavy delay
- Silence all active notes and reset playback
How to install SuperCollider
Platform CLI
claude mcp add --env SC_HOST=<SC_HOST> --env SC_PORT=<SC_PORT> --transport stdio supercollider -- uvx supercollider-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from supercollider-mcp <command>
Platform CLI
codex mcp add supercollider --env SC_HOST=<SC_HOST> --env SC_PORT=<SC_PORT> -- uvx supercollider-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from supercollider-mcp <command>
Config file
{
"mcpServers": {
"supercollider": {
"command": "uvx",
"args": [
"supercollider-mcp"
],
"env": {
"SC_HOST": "<SC_HOST>",
"SC_PORT": "<SC_PORT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from supercollider-mcp <command>
Config file
{
"servers": {
"supercollider": {
"type": "stdio",
"command": "uvx",
"args": [
"supercollider-mcp"
],
"env": {
"SC_HOST": "<SC_HOST>",
"SC_PORT": "<SC_PORT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from supercollider-mcp <command>
Platform CLI
gemini mcp add -e SC_HOST=<SC_HOST> -e SC_PORT=<SC_PORT> supercollider uvx supercollider-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from supercollider-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SuperCollider
How to install SuperCollider in Claude Code?
Run claude mcp add supercollider-mcp -- uvx supercollider-mcp. For non-standard network setups, pass --env SC_HOST=<SC_HOST> --env SC_PORT=<SC_PORT>.
What does SuperCollider do?
It gives coding assistants direct access to sound synthesis via OSC. The server generates melodies, percussion grids, chords, and generative textures on your local audio engine.
What is required to run SuperCollider?
You need SuperCollider version 3.10 or newer with scsynth booted on UDP port 57110, plus Python 3.10+ or uvx available in PATH.