AbletonMCP Enhanced

AbletonMCP 增强版 - Ableton Live 的 AI 控制

该工具通过模型上下文协议 (MCP) 将 Ableton Live 连接到 Claude 和 Cursor 等 AI 助手，让您可以使用自然语言命令控制 Ableton Live。

这是 Siddharth Ahuja 开发的原始AbletonMCP的增强版，经过了重大改进，使其更易于安装和使用。

您可以使用此工具做什么

• 创建和操作 MIDI 和音轨
• 从 Ableton 库中加载乐器、效果和声音
• 创建和编辑带有注释的 MIDI 剪辑
• 控制播放（开始、停止、播放片段）
• 调整设备参数（如 EQ 设置）
• 还有更多！

音乐制作人快速入门指南

选项 1：通过 Smithery 安装（最简单）

如果您使用的是 Claude Desktop，最简单的安装方法是使用 Smithery：

这将自动在 Claude Desktop 中设置 MCP 服务器。您仍然需要安装 Ableton Remote Script（请参阅下面的步骤 4）。

选项 2：手动安装

步骤 1：安装 Python（一次性设置）

如果你没有安装 Python：

1. 下载并安装 Python 3.10 或更新版本：
   • 对于 Mac：下载 Python
   • 对于 Windows：下载 Python
2. 安装过程中，请务必勾选“将 Python 添加到 PATH”

第 2 步：安装 AbletonMCP（一次性设置）

打开终端（Mac）或命令提示符（Windows）并运行以下命令：

步骤 3：安装 Ableton Remote 脚本（一次性设置）

打开相同的终端/命令提示符窗口：

如果自动安装不起作用，该工具将告诉您手动放置文件的位置。

步骤 4：设置 Ableton Live（一次性设置）

1. 启动 Ableton Live
2. 前往“偏好设置”→“链接、速度和 MIDI”
3. 在控制界面下拉菜单中，选择“AbletonMCP_Remote_Script”
4. 将输入和输出设置为“无”
5. 点击“确定”保存设置

步骤5：连接到你的AI助手

对于 Claude 桌面：

1. 前往 Claude → 设置 → 开发者 → 编辑配置
2. 将其添加到您的claude_desktop_config.json中：

将PATH_TO_YOUR_ENVIRONMENT替换为您创建环境的完整路径。例如：

• Mac： /Users/yourusername/ableton-mcp-env
• Windows： C:\Users\yourusername\ableton-mcp-env

对于光标：

1. 前往光标设置 → MCP
2. 添加此命令：

按照上面的说明替换PATH_TO_YOUR_ENVIRONMENT 。

对于其他AI工具：

任何支持 MCP 的 AI 工具都可以通过将其指向您环境中的ableton-mcp server命令来连接。

第六步：开始用人工智能创作音乐！

1. 打开 Ableton Live
2. 打开你的AI助手（Claude，Cursor等）
3. 开始让你的 AI 控制 Ableton！

注意：如果您通过 Smithery（选项 1）安装，则可以跳过手动安装的步骤 1-3 和 5。您只需安装 Ableton Remote Script（步骤 4），即可开始使用！

尝试的示例命令

• “使用合成低音乐器创建新的 MIDI 音轨”
• “为轨道 1 添加混响”
• “创建一个带有简单旋律的 4 小节 MIDI 片段”
• “将鼓架装入轨道 2”
• “为轨道 1 中的剪辑添加爵士和弦进行”
• “将节奏设置为 120 BPM”
• “播放轨道 2 中的剪辑”
• “将低切 EQ 预设应用于轨道 1”

故障排除

连接问题

• 使用 AI 命令之前**，请确保 Ableton Live 正在运行**
• 检查 Ableton 的 MIDI 偏好设置中是否启用了远程脚本
• 如果遇到连接问题**，请重新启动 Ableton 和 AI 助手**

常见错误

• “未找到命令” ：确保您已使用source ableton-mcp-env/bin/activate (Mac/Linux) 或ableton-mcp-env\Scripts\activate (Windows) 激活了您的环境
• “无法连接到 Ableton” ：确保 Ableton 正在运行并且远程脚本已启用
• “未找到远程脚本” ：尝试再次运行ableton-mcp install或按照手动安装说明进行操作

获取帮助

如果您仍然遇到问题，请查看GitHub 问题页面或创建包含问题详细信息的新问题。

高级用法

对于那些熟悉命令行工具的用户，AbletonMCP 提供了额外的命令：

致谢

这个项目基于 Siddharth Ahuja 的原版AbletonMCP 。我在此基础上创建了一个增强版本，添加了更多功能并进行了改进。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

免责声明

这是第三方集成，不是由 Ableton 制作的。