AbletonMCP 增强版

AbletonMCP 增强版 - Ableton Live 的 AI 控制

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

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

您可以使用此工具做什么

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

音乐制作人快速入门指南

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

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

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

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

选项 2：手动安装

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

如果你没有安装 Python：

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

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

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

# Create a folder for AbletonMCP
python -m venv ableton-mcp-env

# On Mac/Linux:
source ableton-mcp-env/bin/activate

# On Windows:
ableton-mcp-env\Scripts\activate

# Install AbletonMCP
pip install git+https://github.com/itsuzef/ableton-mcp.git

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

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

# Install the Remote Script to Ableton
ableton-mcp install

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

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

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

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

对于 Claude 桌面：

前往 Claude → 设置 → 开发者 → 编辑配置
将其添加到您的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

对于光标：

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

PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp server

按照上面的说明替换PATH_TO_YOUR_ENVIRONMENT 。

对于其他AI工具：

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

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

打开 Ableton Live
打开你的AI助手（Claude，Cursor等）
开始让你的 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 提供了额外的命令：

# Show version information
ableton-mcp version

# Show available MCP functions
ableton-mcp info

# Start the server with custom host/port
ableton-mcp server --host 127.0.0.1 --port 8080

致谢

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

执照

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

免责声明

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

AbletonMCP Enhanced

Integrations