AbletonMCP 使用说明

项目简介

AbletonMCP 是一个 MCP 服务器实现，旨在将 Ableton Live 音乐制作软件与支持 Model Context Protocol (MCP) 的客户端（如 Claude AI 或 Cursor 编辑器）连接起来。通过 AbletonMCP，用户可以使用自然语言提示，让 AI 助手直接与 Ableton Live 交互，实现音乐创作、编辑和会话控制等功能。

主要功能点

双向通信: 通过 Socket 服务器连接 Claude AI 和 Ableton Live，实现双向指令和数据传输。
音轨控制: 创建、修改和操作 MIDI 和音频轨道，例如添加新的音轨。
乐器和效果器选择: 允许 AI 从 Ableton Live 的资源库中选择和加载合适的乐器、效果器和声音。
片段 (Clip) 创建: 创建和编辑 MIDI 片段，包括添加音符。
会话控制: 控制 Ableton Live 会话的播放、停止、片段触发和速度调整等。
浏览器访问: 允许 AI 浏览和加载 Ableton Live 的浏览器项目，例如乐器、效果器和音频文件。

安装步骤

环境准备:
- 确保已安装 Ableton Live 10 或更高版本。
- 确保已安装 Python 3.8 或更高版本。
- 安装 uv 包管理器。根据您的操作系统，按照 uv 官方网站的指引进行安装。macOS 用户可以使用 'brew install uv' 命令安装。务必先安装 UV，再进行后续步骤。
安装 Ableton Remote Script:
- 从仓库下载 'AbletonMCP_Remote_Script/init.py' 文件。
- 将 'AbletonMCP_Remote_Script' 文件夹复制到 Ableton Live 的 MIDI Remote Scripts 目录。目录位置可能因操作系统和 Ableton Live 版本而异，请参考以下路径，选择一个适合您的路径：
  
  macOS:
  - 'Applications/Ableton Live.app/Contents/App-Resources/MIDI Remote Scripts/' (右键 Ableton Live 应用，选择 "显示包内容")
  - '/Users/[您的用户名]/Library/Preferences/Ableton/Live XX/User Remote Scripts' (将 XX 替换为您的 Ableton Live 版本号)
  Windows:
  - 'C:\Users[您的用户名]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts'
  - 'C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts'
  - 'C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts' (将 XX 替换为您的 Ableton Live 版本号)
- 在 Remote Scripts 目录下创建一个名为 'AbletonMCP' 的文件夹，并将下载的 'init.py' 文件粘贴到 'AbletonMCP' 文件夹中。
- 启动 Ableton Live。
- 在 Ableton Live 的 "偏好设置" (Preferences) -> "Link/Tempo/MIDI" 选项卡中，将 "控制界面" (Control Surface) 下拉菜单设置为 "AbletonMCP"。
- 将 "输入" (Input) 和 "输出" (Output) 设置为 "无" (None)。

服务器配置

配置 Claude for Desktop (Claude 桌面版)

打开 Claude 桌面应用，进入 "Settings" -> "Developer" -> "Edit Config" -> 'claude_desktop_config.json'，添加以下 JSON 配置：

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

'command': 指定用于启动 MCP 服务器的命令，这里使用 'uvx' 运行 'ableton-mcp'。
'args': 命令参数，这里指定运行 'ableton-mcp'。

配置 Cursor 编辑器

如果您使用 Cursor 编辑器，请进入 Cursor 的 "Settings" -> "MCP"，粘贴以下命令作为 MCP 服务器启动命令：

uvx ableton-mcp

'uvx ableton-mcp': 使用 'uvx' 命令非永久性地运行 'ableton-mcp'，方便测试和开发。

⚠️ 注意： 请仅运行一个 MCP 服务器实例，不要同时在 Claude Desktop 和 Cursor 中运行。

基本使用方法

启动 Ableton Live 并加载 Remote Script: 确保 Ableton Live 已启动，并且 AbletonMCP Remote Script 已正确加载（在 "偏好设置" -> "Link/Tempo/MIDI" 中已配置 AbletonMCP 控制界面）。
配置 MCP 客户端: 根据您使用的 MCP 客户端 (Claude Desktop 或 Cursor) 配置 AbletonMCP 服务器的启动命令。
建立连接: 当您在 Claude 或 Cursor 中与 AI 助手交互时，AbletonMCP 服务器应自动启动并与 Ableton Live 建立连接。您会在 Claude 或 Cursor 界面中看到一个锤子图标，表示 AbletonMCP 工具已连接。
使用提示词: 您可以使用自然语言提示词，指示 AI 助手控制 Ableton Live，例如：
- "创建一个 80 年代 Synthwave 风格的音轨"
- "添加混响到我的鼓组"
- "在 Track 1 的 Clip 中添加爵士和弦进行"
- "将速度设置为 120 BPM"

关键词