AbletonMCP 增强版 - 通过AI助手控制Ableton Live

此工具通过模型上下文协议（MCP）将Ableton Live连接到AI助手（如Claude和Cursor），允许您使用自然语言命令来控制Ableton Live。

这是Siddharth Ahuja的原始AbletonMCP的一个增强分支，进行了大量改进以使其更易于安装和使用。

您可以使用此工具做什么

• 创建和操作MIDI和音频轨道
• 从Ableton库中加载乐器、效果和声音
• 创建和编辑带有音符的MIDI片段
• 控制播放（开始、停止、触发片段）
• 调整设备参数（如均衡器设置）
• 还有很多其他功能！

音乐制作人的快速入门指南

方案1：通过Smithery安装（最简单）

如果您正在使用Claude Desktop，最简单的安装方式是通过Smithery：

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

这将自动在Claude Desktop中设置MCP服务器。您仍然需要安装Ableton远程脚本（见下文步骤4）。

方案2：手动安装

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

如果您尚未安装Python：

1. 下载并安装Python 3.10或更高版本：

   • 对于Mac：下载Python
   • 对于Windows：下载Python

2. 在安装过程中，请确保选中“将Python添加到PATH”

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

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

# 为AbletonMCP创建一个文件夹
python -m venv ableton-mcp-env

# 在Mac/Linux上：
source ableton-mcp-env/bin/activate

# 在Windows上：
ableton-mcp-env\Scripts\activate

# 安装AbletonM
pip install git+https://github.com/itsuzef/ableton-mcp.git

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

在同一终端/命令提示符窗口中：

# 将远程脚本安装到Ableton
ableton-mcp install

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

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

1. 启动Ableton Live
2. 转到首选项 → 链接、速度与MIDI
3. 在控制表面下拉菜单中选择“AbletonMCP_Remote_Script”
4. 将输入和输出设置为“无”
5. 单击“确定”保存设置

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

对于Claude Desktop：

1. 转到Claude → 设置 → 开发者 → 编辑配置
2. 在您的claude_desktop_config.json中添加以下内容：

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp",
            "args": [
                "server"
            ]
        }
    }
}

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

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

对于Cursor：

1. 转到Cursor设置 → MCP
2. 添加以下命令：

PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp server

按照上述说明替换PATH_TO_YOUR_ENVIRONMENT。

对于其他AI工具：

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

步骤6：开始用AI创作音乐！

1. 打开Ableton Live
2. 打开您的AI助手（Claude、Cursor等）
3. 开始要求您的AI控制Ableton！

注意：如果您是通过Smithery（方案1）安装的，您可以跳过手动安装中的步骤1-3和5。您只需要安装Ableton远程脚本（步骤4），然后就可以开始了！

可尝试的示例命令

• “创建一个新的带有合成贝斯乐器的MIDI轨道”
• “在轨道1上添加混响”
• “创建一个带有简单旋律的4小节MIDI片段”
• “将鼓架加载到轨道2”
• “在轨道1的片段中添加爵士和弦进程”
• “将速度设置为120 BPM”
• “播放轨道2中的片段”
• “对轨道1应用低切EQ预设”

故障排除

连接问题

• 确保Ableton Live正在运行，然后再使用AI命令
• 检查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提供了额外的命令：

# 显示版本信息
ableton-mcp version

# 显示可用的MCP函数
ableton-mcp info

# 使用自定义主机/端口启动服务器
ableton-mcp server --host 127.0.0.1 --port 8080

致谢

该项目基于Siddharth Ahuja的原始AbletonMCP。我在此基础上构建了一个具有更多特性和改进的增强版本。

许可证

本项目采用MIT许可证 - 查看LICENSE文件了解详情。

免责声明

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