gluon/max-mcp-server

Max/MSP is a visual programming environment used by musicians, sound designers, and artists to build audio and multimedia setups by connecting boxes (called objects) with virtual cables. This project is an early-stage tool that lets you describe what you want to build in plain language and have an AI assistant translate that into a working Max patch, without you having to drag and drop objects by hand. There are two ways to use it. The first is as an external server that talks to an AI client like Claude Desktop or Claude Code: you type your instructions in the client, and commands flow through to Max in the background. The second is a chat window that lives directly inside Max itself, so you never leave the application. Both routes share the same underlying system and the same vocabulary of commands. Under the hood, the tool reads the patch back after every change so the AI knows exactly what is there before making further edits. It also consults a database built from Max's own documentation files, so when you ask it to create a specific object, it looks up the real inputs, outputs, and settings instead of guessing. All the plumbing it adds stays hidden, so the AI only ever sees the musical or functional part of your patch. Setup requires Max 8 or 9 and Python 3.10 or later. After cloning the repository and installing the Python package, you open a host patch in Max and leave it running. That patch acts as the bridge: the server sends instructions to it over a network connection, and Max executes them. Connecting it to Claude Desktop takes a short config entry pointing at the server. The project is labeled an early experiment at version 0.4, with known rough edges and limited real-world testing outside the in-Max chat mode. The author welcomes bug reports. If you work in Max and want to prototype patches by describing them rather than building them by hand, this gives you a starting point for that kind of workflow.