Skip to main content
Glama
Ziforge

superclean-mcp

by Ziforge
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

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.

Related MCPs

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.

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ziforge/superclean-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server