Skip to main content
Glama
Ziforge
by Ziforge

superclean-mcp

MCP for Daniel M Karlsson's SuperClean SC pattern engine.

Layers on top of supercollider-mcp's OSC bridge — install setup.scd from that repo first, then use this MCP to control Pdefs, tempo, and hushing.

Install

git clone https://github.com/Ziforge/superclean-mcp
cd superclean-mcp
pip install -e .

Same setup.scd install as supercollider-mcp — this MCP just uses the OSC bridge, no separate boot needed.

Related MCP server: sonic-mcp

Wire into Claude Code

{
  "mcpServers": {
    "superclean": {
      "command": "superclean-mcp"
    }
  }
}

Tools

Category

Tool

What it does

Patterns

play_pdef(name, pattern_code)

Define + play a Pdef

Patterns

stop_pdef(name)

Stop by name

Patterns

clear_pdef(name)

Stop + remove from registry

Patterns

hush()

Stop all Pdefs (SuperClean muscle memory)

Patterns

list_pdefs()

Enumerate all Pdefs + isPlaying state

Patterns

set_pdef_key(name, key, value)

Live-inject a key/value into a running Pdef

Tempo

set_tempo(bpm) / get_tempo()

TempoClock.default

Setup

superclean_setup(numChannels, orbits)

Boot server + ~clean = SuperClean.new

Setup

load_synthdef_file(path)

Load a .scd defining a SynthDef

Example prompts

  • "Start a bass Pdef on cv3 that plays a random note from C minor every quarter"

  • "What Pdefs are currently running?"

  • "Push amp: 0.3 into the bass Pdef live"

  • "Hush everything, then start just the pad pattern"

  • "Set BPM to 137"

Attribution

SuperClean is Daniel M Karlsson's SuperCollider quark. This MCP wraps its Pdef surface as MCP tools; the SuperClean project itself lives at https://github.com/dmkarlsson/SuperClean.

Repo

For

supercollider-mcp

Generic SC IDE bridge — this MCP depends on it

phase8-mcp

Korg Phase 8

disting-nt-mcp

Expert Sleepers Disting NT

fh2-mcp

Expert Sleepers FH-2

es9-mcp

Expert Sleepers ES-9

erae-mcp

Embodme ERAE Touch II

elektron-mcp

Elektron devices

License

GPL v2. See LICENSE.

Related MCP Connectors

Related MCP Servers