MaxMSP-MCP Server

What is MaxMSP-MCP Server?

MaxMSP-MCP Server is a Model Context Protocol (MCP) implementation that lets large language models directly understand, explain, and generate Max patches. It is a third-party tool (not made by Cycling ’74) aimed at developers and artists who work with Max/MSP.

How to use MaxMSP-MCP Server?

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.

Key features of MaxMSP-MCP Server

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

Use cases of MaxMSP-MCP Server

• Explaining the structure and logic of a downloaded or user-created Max patch.
• Generating a functional FM synthesizer patch from a natural language prompt.
• Debugging or modifying patches with the help of an LLM agent.
• Assisting new Max users by answering questions about objects and patching.