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
Add this skill
npx mdskills install tiianhk/maxmsp-mcp-serverEnables LLMs to understand and generate MaxMSP patches with clear setup and useful capabilities
1# MaxMSP-MCP Server23This project uses the [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) to let LLMs directly understand and generate Max patches.45### Understand: LLM Explaining a Max Patch678[Video link](https://www.youtube.com/watch?v=YKXqS66zrec). Acknowledgement: the patch being explained is downloaded from [here](https://github.com/jeffThompson/MaxMSP_TeachingSketches/blob/master/02_MSP/07%20Ring%20Modulation.maxpat). Text comments in the original file are deleted.910### Generate: LLM Making an FM Synth111213Check out the [full video](https://www.youtube.com/watch?v=Ns89YuE5-to) where you can listen to the synthesised sounds.1415The 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.1617## Installation1819### Prerequisites2021 - Python 3.8 or newer22 - [uv package manager](https://github.com/astral-sh/uv)23 - 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.2425### Installing the MCP server26271. Install uv:28```29# On macOS and Linux:30curl -LsSf https://astral.sh/uv/install.sh | sh31# On Windows:32powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"33```342. Clone this repository and open its directory:35```36git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git37cd MaxMSP-MCP-Server38```393. Start a new environment and install python dependencies:40```41uv venv42source .venv/bin/activate43uv pip install -r requirements.txt44```454. Connect the MCP server to a MCP client (which hosts LLMs):46```47# Claude:48python install.py --client claude49# or Cursor:50python install.py --client cursor51```52To use other clients (check the [list](https://modelcontextprotocol.io/clients)), you need to download, mannually add the configuration file path to [here](https://github.com/tiianhk/MaxMSP-MCP-Server/blob/main/install.py#L6-L13), and connect by running `python install.py --client {your_client_name}`.5354### Installing to a Max patch5556Use or copy from `MaxMSP_Agent/demo.maxpat`. In the first tab, click the `script npm version` message to verify that [npm](https://github.com/npm/cli) is installed. Then click `script npm install` to install the required dependencies. Switch to the second tab to access the agent. Click `script start` to initiate communication with Python. Once connected, you can interact with the LLM interface to have it explain, modify, or create Max objects within the patch.5758## Disclaimer5960This is a third party implementation and not made by Cycling '74.61
Full transparency — inspect the skill content before installing.