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

Related MCP server: SuperCollider MCP Server

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

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

License

GPL v2. See LICENSE.