用途
MaxMSP-MCP-Server 是一个使用 Model Context Protocol（MCP）的服务器，目的是让大语言模型（LLM）能够直接理解和生成 Max（Max/MSP/Jitter）补丁。根据项目说明，其核心用途分为理解与生成两类：理解方面，LLM 可以解释已有的 Max 补丁；生成方面，LLM 可以创建 Max 对象，例如制作一个 FM 合成器。
主要能力
LLM 智能体可以访问每个对象的官方文档，以及当前补丁和子补丁窗口中的对象。这有助于检索和解释对象、调试，以及验证智能体自身的操作。在 Max 补丁内安装后，用户可以通过 LLM 界面让智能体解释、修改或创建补丁中的 Max 对象。
使用方式与安装要求
环境要求：Python 3.8 或更新版本；uv 包管理器；Max 9 或更新版本（因为部分脚本需要 JavaScript V8 引擎）。项目说明中明确表示尚未在 Max 8 或更早版本上测试。
安装 MCP 服务器：克隆仓库并打开其目录，启动新环境并安装 Python 依赖，然后将 MCP 服务器连接到托管 LLM 的 MCP 客户端。若使用其他客户端，需要下载并手动将配置文件路径添加到指定位置，并通过运行 python install.py --client {your_client_name} 进行连接。
安装到 Max 补丁：使用或复制 MaxMSP_Agent/demo.maxpat。在第一个标签页中，点击“script npm version”消息以验证 npm 是否已安装；然后点击“script npm install”安装所需依赖。切换到第二个标签页以访问智能体。点击“script start”启动与 Python 的通信。连接后，即可与 LLM 界面交互，让它解释、修改或创建补丁中的 Max 对象。
适用场景
适用于需要在 Max/MSP/Jitter 可视化编程环境中借助 LLM 进行补丁理解、对象解释、调试辅助、对象生成与修改的音乐与多媒体编程场景。项目提供了视频演示，包括“LLM 解释 Max 补丁”和“LLM 制作 FM 合成器”。
限制与说明
该项目为第三方实现，并非由 Cycling '74 制作。环境要求为 Python 3.8 或更新版本、uv 包管理器、Max 9 或更新版本；尚未在 Max 8 或更早版本上测试。其他客户端的连接需要手动配置。扩展版本由 ersatzben 和 BenCello 提供，地址为 https://github.com/ersatzben/maxmsp-mcp。
