MaxMSP-MCP-Server

MaxMSP-MCP-Server

35
developer_tools

MaxMSP-MCP Server is a tool that integrates Model Context Protocol to enable large language models to understand and generate Max patches. It facilitates functionalities such as explaining, modifying, and creating Max objects by interacting with an LLM interface. The project requires Python, uv package manager, and Max 9 or newer.

MaxMSP-MCP Server

This project uses the Model Context Protocol (MCP) to enable large language models (LLMs) to understand and generate Max patches. It provides the following functionalities:

  • Understand Max Patch: An LLM explains Max patches with resources from official documentation and subpatch windows.
  • Generate FM Synth: An LLM generates FM synthesis using available resources.

Installation

Prerequisites:

  • Python 3.8 or newer
  • uv package manager
  • Max 9 or newer

Steps:

  1. Install uv package manager.
  2. Clone the repository and navigate to its directory.
  3. Set up a new environment and install Python dependencies using uv.
  4. Connect the MCP server to a client supporting LLM, such as Claude or Cursor.

Max Patch Configuration

To integrate with a Max patch, use 'MaxMSP_Agent/demo.maxpat'. Verify npm installation and install dependencies. Connect to the LLM interface to explain, modify, or create Max objects within the patch.