注: ersatzbenとBenCelloによる拡張版は以下のサイトでご覧いただけます:https://github.com/ersatzben/maxmsp-mcp

MaxMSP-MCPサーバー

このプロジェクトでは、モデルコンテキストプロトコル(MCP)を用いて、LLMが直接Maxパッチを理解し生成できるようにします。

理解:LLMがMaxパッチを説明する

ビデオリンク。謝辞:説明されているパッチはここからダウンロードされています。元のファイル内のテキストコメントは削除されています。

生成:LLMがFMシンセを作る

合成音を聴くことができるフルビデオをご覧ください。

LLMエージェントは各オブジェクトの公式ドキュメントだけでなく、現在のパッチやサブパッチウィンドウ内のオブジェクトにもアクセスできるため、オブジェクトの取得・説明、デバッグ、動作の検証に役立ちます。

設置

前提条件

• Python 3.8以降
• UVパッケージマネージャー
• Max 9以降(一部のスクリプトはJavascript V8エンジンを必要とするため)で、Max 8以前のバージョンではまだテストしていません。

MCPサーバーのインストール

1. UVのインストール:

2. このリポジトリをクローンし、そのディレクトリを開きます:

3. 新しい環境を起動し、Python依存関係をインストールする:

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.