🚀 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 服务器
- 安装 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"
- 克隆此仓库并打开其目录：
git clone https://github.com/tiianhk/MaxMSP-MCP-Server.git
cd MaxMSP-MCP-Server
- 创建新环境并安装 Python 依赖项：
uv venv
uv pip install -r requirements.txt
- 将 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 官方制作。