Maxmsp MCP Server

🚀 Maxmsp - Mcp サーバー

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

🚀 クイックスタート

理解：LLLM が Max パッチを解釈する

動画リンク。謝辞：解釈されるパッチはここから取得されました。元のファイルのテキスト注釈は削除されています。

生成：LLLM が FM シンセサイザーを作成する

合成音を聴くことができる完全版動画をご覧ください。

LLLMエージェントは、各オブジェクトの公式ドキュメント、および現在のパッチとサブパッチウィンドウ内のオブジェクトにアクセスできます。これにより、オブジェクトの検索と解釈、デバッグ、および自身の動作の検証が容易になります。

📦 インストール

前提条件

• Python 3.8 以上
• uv パッケージマネージャー
• Max 9 以上（一部のスクリプトはJavascript V8エンジンを必要とするため）。Max 8 以下のバージョンでのテストは行っていません。

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

1. uv をインストールします：

# macOS と Linux の場合：
curl -LsSf https://astral.sh/uv/install.sh | sh
# 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
uv pip install -r requirements.txt

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

# Claude を使用する場合：
python install.py --client claude
# または 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 の公式制作ではありません。