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.

FAQ from MaxMSP-MCP Server

What does the server do?

It enables LLMs to understand and generate Max patches by exposing Max objects, documentation, and patch structure through the Model Context Protocol.

What are the prerequisites?

Python 3.8 or newer, the uv package manager, and Max 9 or newer (due to JavaScript V8 engine requirements). Max 8 and earlier have not been tested.

How do I connect the server to an MCP client?

Run python install.py --client claude for Claude Desktop, python install.py --client cursor for Cursor, or manually add the configuration file path for other clients listed in install.py.

Is this an official Cycling ’74 product?

No, this is a third-party implementation not made by Cycling ’74. An extended version by ersatzben and BenCello is available at https://github.com/ersatzben/maxmsp-mcp.

What transport does the server use?

The server communicates via the standard MCP protocol using a client-server model. The README describes connection to common MCP clients but does not specify the exact transport layer.