MaxMSP-MCP-Server

This project uses the Model Context Protocol (MCP) to let LLMs directly understand and generate Max patches.

Video link. Acknowledgement: the patch being explained is downloaded from here. Text comments in the original file are deleted.

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.

• 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.

1. Install uv:

# On macOS and Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

1. Clone this repository and open its directory:

git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
cd MaxMSP-MCP-Server

1. Start a new environment and install python dependencies:

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

1. Connect the MCP server to a MCP client (which hosts LLMs):

# Claude:
python install.py --client claude
# or Cursor:
python install.py --client cursor

To use other clients (check the list), you need to download, mannually ad