참고: ersatzben과 BenCello가 만든 확장판은 다음 https://github.com/ersatzben/maxmsp-mcp에서 찾을 수 있습니다.

MaxMSP-MCP 서버

이 프로젝트는 모델 컨텍스트 프로토콜(MCP)을 사용하여 LLM이 직접 Max 패치를 이해하고 생성할 수 있도록 합니다.

이해하기: 맥스 패치 설명하는 LLM

영상 링크. 감사의 말: 설명하는 패치는 여기에서 다운로드됩니다. 원본 파일에 있는 텍스트 댓글은 삭제되었습니다.

생성: LLM FM 신스 생성

전체 영상에서 합성된 사운드를 들을 수 있습니다.

LLM 에이전트는 각 객체의 공식 문서뿐만 아니라 현재 패치 및 서브패치 창의 객체들에 접근할 수 있어, 객체를 검색하고 설명하며, 디버깅하고 자신의 동작을 검증하는 데 도움을 줍니다.

설치

전제 조건

• Python 3.8 또는 그 이후
• UV 패키지 관리자
• Max 9 또는 그 이후(일부 스크립트는 Javascript V8 엔진이 필요하기 때문에), 아직 Max 8 또는 그 이전 버전에서는 테스트하지 않았습니다.

MCP 서버 설치

1. UV 설치:

2. 이 저장소를 복제하고 디렉터리를 엽니다:

3. 새 환경을 시작하고 파이썬 의존성을 설치하세요:

Note: An extended version by ersatzben and BenCello can be found at: https://github.com/ersatzben/maxmsp-mcp

MaxMSP-MCP Server

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

Understand: LLM Explaining a Max Patch

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

Generate: LLM Making an FM Synth

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.

Installation

Prerequisites

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

Installing the MCP server

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"

2. Clone this repository and open its directory:

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

3. Start a new environment and install python dependencies:

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

4. 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 add the configuration file path to here, and connect by running python install.py --client {your_client_name}.

Installing to a Max patch

Use or copy from MaxMSP_Agent/demo.maxpat. In the first tab, click the script npm version message to verify that npm 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.

Disclaimer

This is a third party implementation and not made by Cycling '74.