Maxmsp MCP Server

🚀 Maxmsp-Mcp 服務器

本項目藉助模型上下文協議 (MCP)，實現大型語言模型（LLMs）對 Max 補丁的直接理解與生成，為相關開發和應用帶來便利。

🚀 快速開始

本項目利用模型上下文協議，讓大型語言模型具備理解和生成 Max 補丁的能力。以下為您展示其具體功能及效果：

理解：LLLM 解釋一個 Max 補丁

視頻鏈接。特別感謝：所解釋的補丁來自此處，原始文件中的文本註釋已刪除。

生成：LLLM 創建一個 FM 合成器

您可查看完整視頻，在視頻中能聽到合成的聲音。

LLLM 代理可訪問每個對象的官方文檔，以及當前補丁和子補丁窗口中的對象，這極大地助力於對象的檢索、解釋、調試和自身行為驗證。

✨ 主要特性

• 基於模型上下文協議，實現大型語言模型與 Max 補丁的交互。
• 具備理解和生成 Max 補丁的功能。
• LLLM 代理可利用官方文檔及窗口對象進行輔助操作。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• uv 包管理器
• Max 9 或更高版本（因為某些腳本需要 Javascript V8 引擎），尚未在 Max 8 或更早版本的 Max 上進行測試。

安裝 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安裝所需的依賴項。切換到第二個選項卡以訪問代理。點擊script start以開始與 Python 的通信。連接後，您可以使用 LLM 接口與其互動，讓其解釋、修改或創建補丁中的 Max 對象。

📄 許可證

此實現為第三方實施，非 Cycling '74 官方製作。