millumin-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@millumin-mcp launch column 2 and set the video master to 0.8"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
millumin-mcp
An MCP server that lets Claude Code, or any MCP client, control Millumin on macOS through its OSC API.
It runs locally over stdio, started by the client. It sends OSC to Millumin and can listen for Millumin's feedback. Tested with Millumin 5.14.
Tools
Tool | Purpose |
| Run |
| Set a property on a target (default |
| Set the |
| Send any OSC address |
| Send |
| Send |
| Read recent feedback, optionally filtered |
Related MCP server: supercollider-mcp
Setup
In Millumin's Device manager (⌘K), OSC tab:
OSC listener on input port 5678.
For feedback: an OSC sender to
127.0.0.1port 5679, with feedback on.
Build the server (Node 20 or later):
git clone https://github.com/jpkelly/millumin-mcp.git
cd millumin-mcp
npm install
npm run buildAdd it to your MCP client:
{
"mcpServers": {
"millumin": {
"command": "node",
"args": ["/path/to/millumin-mcp/dist/server.js"],
"env": { "MILLUMIN_FEEDBACK_PORT": "5679" }
}
}
}Variable | Default | |
|
| Where Millumin runs |
|
| Millumin's OSC listener port |
| unset | Port to receive feedback on; unset turns feedback off |
| unset |
|
Notes
Millumin's OSC API can't create layers, canvases, outputs or routings. Make those in Millumin.
selectedLayerfollows the selection in Millumin's interface. Targetindex:Nwhen the selection may change.Launching a column that is already playing doesn't restart it.
goToTime [0]restarts all media together.Feedback gives layer names in lowercase.
Tests
npm testRuns against a fake Millumin on a loopback port, never a real one.
License
Available Tools
7 toolsmillumin_actionB
Run a Millumin action, e.g. launchColumn [index or name], stopColumn, launchNextColumn, playOrPause, goToTime [seconds], selectLayer [index or name], displayTestCard, hideTestCard.
Inputs: name (required), args.
millumin_feedbackA
Return recent feedback messages from Millumin (addresses start with /millumin), optionally filtered by a case-insensitive substring such as "launchedColumn" or "layer:Intro".
Inputs: pattern, sinceSeconds.
millumin_masterB
Set a master level: video, audio, or dmx. Value is normalized 0..1.
Inputs: value (required), channel (required).
millumin_pingB
Send /ping and return the layer and board state Millumin reports back. Requires MILLUMIN_FEEDBACK_PORT and Millumin's OSC "API feedback" enabled and pointed at that port.
Inputs: waitMs.
millumin_queryA
Ask Millumin for the current value of one property by sending address + "/?", then return any feedback that came back. Example address: /layer:Intro/opacity.
Inputs: address (required), waitMs.
millumin_send_rawA
Send an arbitrary OSC message to Millumin. Use only when no typed tool fits. Destructive addresses (/action/quit, /action/saveProject) are refused unless the server was started with MILLUMIN_ALLOW_DESTRUCTIVE=1.
Inputs: address (required), args.
millumin_setB
Set a property on a target. Target defaults to selectedLayer; other forms are layer:, light:, index:, or an element name. Property examples: opacity, position/x, position/xy, rotation, scale, intensity, media/speed, media/normalizedTime.
Inputs: value (required), property (required), target.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
The typed tools separate command execution (millumin_action), property setting (millumin_set), and master-level setting (millumin_master) clearly. millumin_query, millumin_feedback, and millumin_ping all expose feedback/state but with distinguishable purposes, while millumin_send_raw overlaps everything as a fallback, keeping this from a perfect score.
All names share the millumin_ prefix and snake_case, which aids readability. However, suffixes mix nouns and verbs (action, master, feedback, ping, query vs set, send_raw) rather than following a single predictable verb_noun convention.
Seven tools is well within the appropriate range for an OSC control bridge. Each tool has a distinct role: typed control, master control, raw fallback, and introspection.
The surface covers core control and introspection: actions, property setting, master levels, targeted queries, recent feedback, ping state, and raw OSC as an escape hatch. Typed discovery/listing of layers, columns, media, or available properties is not provided, though raw OSC can fill those gaps.
Maintenance
Related MCP Connectors
OSC ↔ MIDI bridge for synthesizers and DAWs, with the SynthHub catalogue. A MIDI MCP and OSC MCP.
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Remote MCP access to authorized Mac and Windows computers, with consent and STOP controls.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables control of a running TouchDesigner instance via MCP protocol, providing tools to manage operators, parameters, and project state through a local HTTP bridge.161-
- AlicenseNot gradedqualityDmaintenanceBridges MCP clients to a running SuperCollider IDE, enabling code evaluation, state queries, post window capture, and screenshots via OSC.GPL 2.0
- FlicenseAqualityDmaintenanceMCP server that enables control of an ETC Eos lighting console over OSC, supporting cues, channel levels, faders, and macros, with safety guards for destructive actions.133-
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to control Ableton Live through a Max for Live device and optional Remote Script, covering tracks, clips, MIDI notes, mixer settings, transport, and plugin search and insertion.1MIT