使用说明
AbletonMCP增强版-Ableton Live的AI控制
该工具通过模型上下文协议(MCP)将Ableton Live连接到Claude和Cursor等AI助手,允许您使用自然语言命令控制Ableton Live。
这是原始版本的增强版本 AbletonMCP 由Siddharth Ahuja设计,经过重大改进,使其更易于安装和使用。
你可以用这个工具做什么
- 创建和操纵MIDI和音轨
- 从Ableton的库中加载乐器、效果和声音
- 创建和编辑带有音符的MIDI片段
- 控制播放(开始、停止、射击剪辑)
- 调整设备参数(如EQ设置)
- 还有更多!
音乐制作人快速入门指南
选项1:通过Smithery安装(最简单)
如果您使用的是Claude Desktop,最简单的安装方法是使用Smithery:
npx -y @smithery/cli install @itsuzef/ableton-mcp --client claude
这将在Claude Desktop中自动设置MCP服务器。您仍然需要安装Ableton远程脚本(请参阅下面的步骤4)。
选项2:手动安装
第一步:安装Python(一次性设置)
如果你没有安装Python:
步骤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远程脚本(一次性设置)
在相同的终端/命令提示符窗口打开的情况下:
# Install the Remote Script to Ableton
ableton-mcp install
如果自动安装不起作用,该工具将告诉您手动放置文件的位置。
步骤4:设置Ableton Live(一次性设置)
- 启动Ableton Live
- 转到“首选项”→ 链接、节奏和MIDI
- 在控制界面下拉菜单中,选择“AbletonMCP_Remote_Script”
- 将输入和输出设置为“无”
- 点击“确定”保存设置
步骤5:连接到您的AI助手
对于Claude Desktop:
- 去找克劳德→ 设置→ 开发者→ 编辑配置
- 将此添加到您的
claude_desktop_config.json:
{
"mcpServers": {
"AbletonMCP": {
"command": "PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp",
"args": [
"server"
]
}
}
}
替换 PATH_TO_YOUR_ENVIRONMENT 创建环境的完整路径。例如:
- 雨衣:
/Users/yourusername/ableton-mcp-env - 窗户:
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 命令在您的环境中。
第六步:开始用AI创作音乐!
- 打开Ableton直播
- 打开你的AI助手(Claude、Cursor等)
- 开始让你的AI控制Ableton!
备注:如果您是通过Smithery安装的(选项1),则可以跳过手动安装的步骤1-3和5。你只需要安装Ableton远程脚本(步骤4),然后就可以开始了!
要尝试的命令示例
- “使用合成低音乐器创建新的MIDI曲目”
- “为曲目1添加混响”
- “用简单的旋律创建一个4小节MIDI片段”
- “将鼓架装入轨道2”
- “在曲目1中的剪辑中添加爵士和弦级数”
- “将节奏设置为120 BPM”
- “播放曲目2中的剪辑”
- “将低切EQ预设应用于曲目1”
故障排除
连接问题
- 确保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提供了额外的命令:
# 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
致谢
该项目基于原始 AbletonMCP 悉达多Ahuja。我在此基础上创建了一个具有额外功能和改进的增强版本。
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
免责声明
这是第三方集成,不是由Ableton制作的。