🚀 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 官方制作。