MaxMSP-MCP Server

注： ersatzben と BenCello による拡張版はこちらです：https://github.com/ersatzben/maxmsp-mcp

MaxMSP-MCP Server

このプロジェクトでは、Model Context Protocol（MCP）を使用して、LLM が Max パッチを直接理解し、生成できるようにします。

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

動画へのリンク。謝辞：説明対象のパッチはこちらからダウンロードしたものです。元ファイル内のテキストコメントは削除されています。

生成：FM シンセを作る LLM

合成されたサウンドを聴ける動画全編をご覧ください。

LLM エージェントは、各オブジェクトの公式ドキュメントに加え、現在のパッチやサブパッチウィンドウにあるオブジェクトにもアクセスできます。これにより、オブジェクトの検索や説明、デバッグ、自身の操作の検証が可能になります。

インストール

前提条件

• Python 3.8 以降
• uv パッケージマネージャー
• Max 9 以降（スクリプトの一部で Javascript V8 エンジンが必要なため）。Max 8 以前のバージョンではまだテストしていません。

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

1. 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. このリポジトリをクローンし、そのディレクトリを開きます：

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

3. 新しい環境を作成し、Python の依存関係をインストールします：

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

4. MCP サーバーを、LLM をホストする MCP クライアントに接続します：

# Claude:
python install.py --client claude
# or Cursor:
python install.py --client cursor

ほかのクライアントを使用する場合（一覧を確認してください）は、こちらから設定ファイルのパスをダウンロードして手動で追加し、python install.py --client {your_client_name} を実行して接続する必要があります。

Max パッチへのインストール

MaxMSP_Agent/demo.maxpat を使用するか、コピーしてください。最初のタブで script npm version メッセージをクリックし、npm がインストールされていることを確認します。次に script npm install をクリックして、必要な依存関係をインストールします。2 番目のタブに切り替えると、エージェントにアクセスできます。script start をクリックして Python との通信を開始します。接続したら、LLM インターフェースを操作して、パッチ内の Max オブジェクトの説明、変更、作成を行えます。

免責事項

これはサードパーティによる実装であり、Cycling '74 が作成したものではありません。