mcp server

supercollider-mcp

MCP bridge to a running SuperCollider IDE via OSC. Evaluate SC code, query state, capture post window without pasting.

Ziforge/supercollider-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "supercollider-mcp": {
      "command": "uvx",
      "args": [
        "supercollider-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 24, 2026

supercollider-mcp

MCP bridge to a running SuperCollider IDE. Lets an MCP client (Claude Code, Cursor, Continue, etc.) evaluate SC code, query values, capture the post window, and screenshot Qt windows without the user having to paste anything.

Sits alongside the other Ziforge MCPs for the EMS Stockholm rig — see Related MCPs.

How it works

sclang has a built-in OSC listener on port 57120. The setup.scd this repo ships with installs an OSCdef on /mcpEval that runs whatever code the MCP sends. Results come back on /mcpReply on port 57121, keyed by a request id.

Once you evaluate setup.scd in your IDE once per SC session, every MCP-side sc_eval call goes through OSC — no need to keep pasting.

Claude ↔ MCP server ↔ OSC :57120 → sclang → OSC :57121 → MCP → Claude

Install

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

Or with uv:

uv pip install -e .

Wire into Claude Code

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

Setup — one line per SC session

Open your SC IDE, evaluate this once:

"~/Projects/supercollider-mcp/setup.scd".standardizePath.load;

You should see in the post window:

supercollider-mcp: listener installed on /mcpEval + /mcpPost (port 57120).
supercollider-mcp: replies sent to /mcpReply on 57121.

That's it. Now MCP calls work.

Tools

Category	Tool	What it does
Eval	`sc_eval(code, timeout)`	Send SC code, get result string
Eval	`sc_query(expression, timeout)`	Same as sc_eval but semantic — for reading state
Eval	`sc_post_recent(n)`	Last N eval results + errors from the OSC buffer
Patterns	`sc_hush()`	`Pdef.all.do(_.stop)`
Server	`sc_boot_server()`	Boot Server.default
Server	`sc_quit_server()`	Quit Server.default
Interp	`sc_recompile()`	Recompile class library (destroys the OSC listener — re-run setup.scd after)
Windows	`sc_list_windows()`	Enumerate sclang / SuperCollider windows via osascript (macOS)
Windows	`sc_screenshot(save_path)`	screencapture full screen (macOS) — the sclang Qt windows appear on it
Setup	`sc_setup_listener_scd_path()`	Return absolute path to setup.scd for the current install

Limitations

sc_recompile kills the listener. After a class-library recompile, the OSC listener is gone. You must re-evaluate setup.scd. There's no way around this — recompile reboots the interpreter.
Post window is partial. sc_post_recent only shows results of MCP-issued evaluations, not arbitrary .postln output from patterns or synths. sclang doesn't expose its Post class's output stream over OSC. If you want to capture that too, wire your Pdefs to emit via NetAddr("127.0.0.1", 57121).sendMsg("/mcpReply", 0, 1, "...") explicitly.
Screenshots are full-screen. Window-ID targeting on macOS needs assistive access permission most sessions don't have. If your terminal has been granted assistive access via System Settings → Privacy → Accessibility, you can tighten this later.

Example prompts (for the MCP client)

"Evaluate SinOsc.ar(440).play in SC and hush after 2 seconds"
"What's the current value of ~ws.destName in SC?"
"Screenshot the SC IDE and describe what the bus view is showing"
"Recompile the class library, then re-install the mcp listener"

Related MCPs

Repo	For
`superclean-mcp`	SuperClean pattern control (Pdef.play, hush, list) — layered on top of this
`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 (fork of zerubeus)

License

GPL v2. See LICENSE.