AbletonMC-boost - Ableton Live 模型上下文协议集成

AbletonMCP 将 Ableton Live 与 Claude AI 通过模型上下文协议（MCP）连接起来，使 Claude 能够直接与 Ableton Live 进行交互和控制。这种集成支持提示辅助音乐制作、音轨创建以及 Live 会话操作。

加入社区

提供反馈，获得灵感，并在 MCP 上构建：Discord。由Siddharth 制作。

维护分支由 kydycode 维护。

功能

• 双向通信：通过基于套接字的服务器将 Claude AI 连接到 Ableton Live
• 音轨操作：创建、修改和操作 MIDI 和音频音轨
• 乐器和效果选择：Claude 可以访问并加载 Ableton 库中的正确乐器、效果和声音
• 片段创建：创建和编辑带有音符的 MIDI 片段
• 会话控制：开始和停止播放，触发片段，控制传输
• 编排功能：创建完整的歌曲编排，包括部分、过渡以及从会话视图到编排视图的自动转换

组件

系统由两个主要组件组成：

1. Ableton 远程脚本 (Ableton_Remote_Script/__init__.py)：一个用于 Ableton Live 的 MIDI 远程脚本，创建一个套接字服务器来接收和执行命令
2. MCP 服务器 (server.py)：一个实现模型上下文协议并连接到 Ableton 远程脚本的 Python 服务器

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Claude Desktop 的 Ableton Live 集成：

npx -y @smithery/cli install @kydycode/ableton-mcp-boost --client claude

先决条件

• Ableton Live 10 或更新版本
• Python 3.8 或更新版本
• uv 包管理器

如果你使用的是 Mac，请通过以下方式安装 uv：

brew install uv

否则，请从 [uv 的官方网站][https://docs.astral.sh/uv/getting-started/installation/] 安装

⚠️ 在安装 UV 之前不要继续

Claude Desktop 集成

跟随设置说明视频

1. 前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 并包含以下内容：

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

Cursor 集成

运行 ableton-mcp-boost 而不通过 uvx 永久安装。前往 Cursor 设置 > MCP 并粘贴此命令：

uvx ableton-mcp-boost

⚠️ 只需在一个地方运行 MCP 服务器实例（要么在 Cursor 上，要么在 Claude Desktop 上），而不是两者都运行

安装 Ableton 远程脚本

跟随设置说明视频

1. 从此仓库下载 AbletonMCP_Remote_Script/__init__.py 文件

2. 将文件夹复制到 Ableton 的 MIDI 远程脚本目录。不同的操作系统和版本有不同的位置。其中一个应该有效，你可能需要查找：

   对于 macOS：

   • 方法 1：前往应用程序 > 右键点击 Ableton Live 应用程序 → 显示包内容 → 导航至： Contents/App-Resources/MIDI Remote Scripts/
   • 方法 2：如果在第一个方法中找不到，使用直接路径（将 XX 替换为你的版本号）： /Users/[用户名]/Library/Preferences/Ableton/Live XX/User Remote Scripts

   对于 Windows：

   • 方法 1： C:\Users[用户名]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts
   • 方法 2： C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\
   • 方法 3： C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\ 注意：将 XX 替换为你的 Ableton 版本号（例如，10, 11, 12）

3. 在远程脚本目录中创建名为 'AbletonMCP' 的文件夹，并粘贴下载的 __init__.py 文件

4. 启动 Ableton Live

5. 前往设置/偏好设置 → 链接、速度及 MIDI

6. 在控制表面下拉菜单中选择 "AbletonMCP"

7. 将输入和输出设置为 "无"

使用

开始连接

1. 确保 Ableton 远程脚本已加载到 Ableton Live 中
2. 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置
3. 当你与 Claude 互动时，连接应自动建立

与 Claude 一起使用

一旦在 Claude 上设置了配置文件，并且远程脚本正在 Ableton 中运行，你会看到一个带有工具的锤子图标，用于 Ableton MCP。

功能

• 获取会话和音轨信息
• 创建和修改 MIDI 和音频音轨
• 创建、编辑和触发片段
• 控制播放
• 从 Ableton 浏览器加载乐器和效果
• 向 MIDI 片段添加音符
• 更改速度和其他会话参数
• 创建带有定义部分（如引子、副歌、主歌等）的完整歌曲编排
• 复制部分并可选地进行变化
• 在部分之间创建过渡（如填充、上升、冲击）
• 将会话视图片段转换为具有结构化布局的编排视图

示例命令

这里有一些你可以要求 Claude 执行的例子：

• "创建一个 80 年代合成波音轨" 演示
• "创建一个 Metro Boomin 风格的嘻哈节拍"
• "创建一个新的带有合成贝斯乐器的 MIDI 音轨"
• "给我的鼓添加混响"
• "创建一个四小节的简单旋律 MIDI 片段"
• "获取当前 Ableton 会话的信息"
• "将 808 鼓架加载到选定的音轨中"
• "在轨道 1 的片段中添加爵士和弦进程"
• "将速度设置为 120 BPM"
• "播放轨道 2 的片段"
• "创建一个 8 小节长的引子部分"
• "从第 16 小节到第 24 小节复制副歌部分，并将其放置在第 32 小节处，带有中等变化"
• "从第 24 小节到第 25 小节创建一个带有鼓填充的过渡"
• "将我的会话片段转换为带有引子、副歌、主歌结构的完整编排"

故障排除

• 连接问题：确保 Ableton 远程脚本已加载，并且 MCP 服务器已在 Claude 上配置
• 超时错误：尝试简化你的请求或将它们分解为更小的步骤
• 重启是否解决问题？：如果你仍然遇到连接错误，请尝试重新启动 Claude 和 Ableton Live

技术细节

通信协议

该系统使用基于 JSON 的简单协议通过 TCP 套接字：

• 命令作为带有 type 和可选 params 的 JSON 对象发送
• 响应是带有 status 和 result 或 message 的 JSON 对象

局限性及安全考虑

• 创建复杂的音乐编排可能需要将其分解为更小的步骤
• 该工具旨在与 Ableton 的默认设备和浏览器项目一起工作
• 在进行大量实验之前，请务必保存你的工作

贡献

欢迎贡献！请随时提交 Pull Request。

免责声明

这是一个第三方集成，并非由 Ableton 制作。