Ableton Live AI控制工具

通过Model Context Protocol (MCP)将Ableton Live与AI助手(如Claude和Cursor)连接,允许使用自然语言命令控制Ableton Live。

  • by itsuzef
  • Python
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 itsuzef/ableton-mcp

使用说明

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:

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

  2. 在安装过程中,请确保选中“将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远程脚本(一次性设置)

在相同的终端/命令提示符窗口打开的情况下:

# Install the Remote Script to Ableton
ableton-mcp install

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

步骤4:设置Ableton Live(一次性设置)

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

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

对于Claude Desktop:

  1. 去找克劳德→ 设置→ 开发者→ 编辑配置
  2. 将此添加到您的 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

对于光标:

  1. 转到光标设置→ MCP
  2. 添加此命令:
PATH_TO_YOUR_ENVIRONMENT/bin/ableton-mcp server

替换 PATH_TO_YOUR_ENVIRONMENT 如上所述。

对于其他AI工具:

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

第六步:开始用AI创作音乐!

  1. 打开Ableton直播
  2. 打开你的AI助手(Claude、Cursor等)
  3. 开始让你的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制作的。