MaxMSP-MCP Server
About
MCP (Model Context Protocol) Server for Max (Max/MSP/Jitter)
Details
- Author
- tiianhk
- GitHub stars
- 242
- Downloads
- 561
- Categories
- Other
Jump to
- Lets LLMs understand and explain existing Max patches.
- Enables LLMs to generate new Max patches from descriptions.
- Provides access to official documentation of each Max object.
- Reads objects in the current patch and subpatch windows.
- Supports debugging and verifying LLM-generated actions.
Install via the uv package manager, clone the repository, create a virtual environment, and install Python dependencies. Then connect the MCP server to a supported client (e.g., Claude or Cursor) by running python install.py --client claude (or --client cursor). Alternatively, import MaxMSP_Agent/demo.maxpat into a Max patch, click the provided script messages to install npm dependencies and start the agent, and interact with the LLM interface inside Max.
MaxMSP-MCP Server
This project uses the Model Context Protocol (MCP) to let LLMs directly understand and generate Max patches.
Understand: LLM Explaining a Max Patch
Video link. Acknowledgement: the patch being explained is downloaded from here. Text comments in the original file are deleted.
Generate: LLM Making an FM Synth
Check out the full video where you can listen to the synthesised sounds.
The LLM agent has access to the official documentation of each object, as well as objects in the current patch and subpatch windows, which helps in retrieving and explaining objects, debugging, and verifying their own actions.
Installation
Prerequisites
- Python 3.8 or newer
- uv package manager
- Max 9 or newer (because some of the scripts require the Javascript V8 engine), we have not tested it on Max 8 or earlier versions of Max yet.
Installing the MCP server
1. Install uv:
```
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
