Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Superclean

FreeNot checked

MCP server that wraps Daniel M Karlsson's SuperClean SC pattern engine, enabling control of Pdefs, tempo, and hushing via Claude Code through an OSC bridge.

Ziforgeby Ziforge
GitHubEmbed

About

MCP server that wraps Daniel M Karlsson's SuperClean SC pattern engine, enabling control of Pdefs, tempo, and hushing via Claude Code through an OSC bridge.

README

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.

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.

from github.com/Ziforge/superclean-mcp

Install Superclean in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install superclean-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add superclean-mcp -- uvx --from git+https://github.com/Ziforge/superclean-mcp superclean-mcp

FAQ

Is Superclean MCP free?

Yes, Superclean MCP is free — one-click install via Unyly at no cost.

Does Superclean need an API key?

No, Superclean runs without API keys or environment variables.

Is Superclean hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Superclean in Claude Desktop, Claude Code or Cursor?

Open Superclean on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

GitHubby GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

mcpdotdirectby mcpdotdirect

Compare Superclean with

SupercleanvsGitHubSupercleanvsFilesystemSupercleanvsMemorySupercleanvsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs