Open in github.dev Open in a new github.dev tab Open in codespace
AbletonMCP connects Ableton Live to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Ableton Live. This integration enables prompt-assisted music production, track creation, and Live session manipulation.
AbletonMCP 通过模型上下文协议 （MCP） 将 Ableton Live 连接到 Claude AI，使 Claude 能够直接与 Ableton Live 交互和控制。此集成支持提示辅助音乐制作、音轨创建和 Live 会话作。
Give feedback, get inspired, and build on top of the MCP: Discord. Made by Siddharth
提供反馈，获得灵感，并在 MCP： Discord 的基础上进行构建。由 Siddharth 制作
Features 特征
- Two-way communication: Connect Claude AI to Ableton Live through a socket-based server
双向通信 ：通过基于套接字的服务器将 Claude AI 连接到 Ableton Live - Track manipulation: Create, modify, and manipulate MIDI and audio tracks
轨道作 ：创建、修改和作 MIDI 和音频轨道 - Instrument and effect selection: Claude can access and load the right instruments, effects and sounds from Ableton’s library
乐器和效果选择 ：Claude 可以从 Ableton 的库中访问和加载正确的乐器、效果和声音 - Clip creation: Create and edit MIDI clips with notes
Clip 创建 ：创建和编辑带有音符的 MIDI Clip - Session control: Start and stop playback, fire clips, and control transport
会话控制 ：开始和停止播放、触发剪辑和控制传输
Components 组件
The system consists of two main components:
该系统由两个主要组件组成：
- Ableton Remote Script (
Ableton_Remote_Script/__init__.py): A MIDI Remote Script for Ableton Live that creates a socket server to receive and execute commands
Ableton Remote Script （Ableton_Remote_Script/__init__.py）：Ableton Live 的 MIDI 远程脚本，用于创建套接字服务器来接收和执行命令 - MCP Server (
server.py): A Python server that implements the Model Context Protocol and connects to the Ableton Remote Script
MCP 服务器 （server.py）：实现模型上下文协议并连接到 Ableton 远程脚本的 Python 服务器
Installation 安装
To install Ableton Live Integration for Claude Desktop automatically via Smithery:
要通过 Smithery 自动安装 Ableton Live Integration for Claude Desktop：
npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude
Prerequisites 先决条件
- Ableton Live 10 or newer
Ableton Live 10 或更高版本 - Python 3.8 or newer Python 3.8 或更高版本
- uv package manager UV 包管理器
If you’re on Mac, please install uv as:
如果您使用的是 Mac，请将 uv 安装为：
brew install uv
Otherwise, install from [uv’s official website][https://docs.astral.sh/uv/getting-started/installation/]
否则，请从 [uv 官网][https://docs.astral.sh/uv/getting-started/installation/] 安装
⚠️ Do not proceed before installing UV
⚠️ 安装 UV 之前不要继续
Follow along with the setup instructions video
按照设置说明视频进行作
- Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
转到 Claude > 设置 > 开发人员 > 编辑配置 > claude_desktop_config.json 以包括以下内容：
{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": [
"ableton-mcp"
]
}
}
}
Run ableton-mcp without installing it permanently through uvx. Go to Cursor Settings > MCP and paste this as a command:
运行 ableton-mcp 而不通过 uvx 永久安装它。转到光标设置 > MCP 并将其粘贴为命令：
uvx ableton-mcp
⚠️ Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both
⚠️ 只运行 MCP 服务器的一个实例（在 Cursor 或 Claude Desktop 上），不能同时运行两者
Follow along with the setup instructions video
按照设置说明视频进行作
- Download the
AbletonMCP_Remote_Script/__init__.pyfile from this repo
从此存储库下载AbletonMCP_Remote_Script/__init__.py文件 - Copy the folder to Ableton’s MIDI Remote Scripts directory. Different OS and versions have different locations. One of these should work, you might have to look:
将文件夹复制到 Ableton 的 MIDI Remote Scripts 目录。不同的作系统和版本具有不同的位置。 其中之一应该有效，您可能需要查看 ：
For macOS:对于 macOS：- Method 1: Go to Applications > Right-click on Ableton Live app → Show Package Contents → Navigate to:
Contents/App-Resources/MIDI Remote Scripts/
方法 1：转到应用程序>右键单击 Ableton Live 应用程序→显示包内容→导航到：Contents/App-Resources/MIDI Remote Scripts/ - Method 2: If it’s not there in the first method, use the direct path (replace XX with your version number):
/Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts
方法 2：如果第一种方法中没有，请使用直接路径（将 XX 替换为您的版本号）：/Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts
For Windows:对于 Windows： - Method 1: C:\Users[Username]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts
方法 1： C：\Users[用户名]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts - Method 2:
C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\
方法 2：C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\ - Method 3:
C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\Note: Replace XX with your Ableton version number (e.g., 10, 11, 12)
方法 3：C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\请注意： 将 XX 替换为您的 Ableton 版本号（例如，10、11、12）
- Method 1: Go to Applications > Right-click on Ableton Live app → Show Package Contents → Navigate to:
- Create a folder called ‘AbletonMCP’ in the Remote Scripts directory and paste the downloaded ‘__init__.py’ file
在 Remote Scripts 目录中创建一个名为 ‘AbletonMCP’ 的文件夹，并粘贴下载的 ‘__init__.py’ 文件 - Launch Ableton Live 启动 Ableton Live
- Go to Settings/Preferences → Link, Tempo & MIDI
转到设置/首选项→链接、速度和 MIDI - In the Control Surface dropdown, select "AbletonMCP"
在 Control Surface（控制界面）下拉菜单中，选择 “AbletonMCP” - Set Input and Output to "None"
将 Input 和 Output 设置为 “None”
Usage 用法
- Ensure the Ableton Remote Script is loaded in Ableton Live
确保 Ableton 远程脚本已加载到 Ableton Live 中 - Make sure the MCP server is configured in Claude Desktop or Cursor
确保在 Claude Desktop 或 Cursor 中配置了 MCP 服务器 - The connection should be established automatically when you interact with Claude
当您与 Claude 互动时，应自动建立连接
Once the config file has been set on Claude, and the remote script is running in Ableton, you will see a hammer icon with tools for the Ableton MCP.
在 Claude 上设置配置文件，并且远程脚本在 Ableton 中运行后，您将看到一个带有 Ableton MCP 工具的锤子图标。
Capabilities 能力
- Get session and track information
获取会话和跟踪信息 - Create and modify MIDI and audio tracks
创建和修改 MIDI 和音频轨道 - Create, edit, and trigger clips
创建、编辑和触发剪辑 - Control playback 控制播放
- Load instruments and effects from Ableton’s browser
从 Ableton 的浏览器加载乐器和效果器 - Add notes to MIDI clips
向 MIDI Clip 添加音符 - Change tempo and other session parameters
更改速度和其他会话参数
Here are some examples of what you can ask Claude to do:
以下是您可以要求 Claude 执行的作的一些示例：
- "Create an 80s synthwave track" Demo
“Create an 80s synthwave track” 演示 - "Create a Metro Boomin style hip-hop beat"
“创建 Metro Boomin 风格的嘻哈节拍” - "Create a new MIDI track with a synth bass instrument"
“使用合成贝司乐器创建新的 MIDI 轨道” - "Add reverb to my drums"
“为我的鼓添加混响” - "Create a 4-bar MIDI clip with a simple melody"
- "Get information about the current Ableton session"
- "Load a 808 drum rack into the selected track"
- "Add a jazz chord progression to the clip in track 1"
- "Set the tempo to 120 BPM"
- "Play the clip in track 2"
Troubleshooting
- Connection issues: Make sure the Ableton Remote Script is loaded, and the MCP server is configured on Claude
- Timeout errors: Try simplifying your requests or breaking them into smaller steps
- Have you tried turning it off and on again?: If you’re still having connection errors, try restarting both Claude and Ableton Live
Technical Details
Communication Protocol
The system uses a simple JSON-based protocol over TCP sockets:
- Commands are sent as JSON objects with a
typeand optionalparams - Responses are JSON objects with a
statusandresultormessage - Creating complex musical arrangements might need to be broken down into smaller steps
- The tool is designed to work with Ableton’s default devices and browser items
- Always save your work before extensive experimentation
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Disclaimer
This is a third-party integration and not made by Ableton.