ahujasid/ableton-mcp
GitHub: ahujasid/ableton-mcp
通过 MCP 协议将 Claude AI 与 Ableton Live 连接，实现用自然语言控制音乐制作流程的集成工具。
Stars: 2530 | Forks: 320
# AbletonMCP - Ableton Live 模型上下文协议集成
[](https://smithery.ai/server/@ahujasid/ableton-mcp)
AbletonMCP 通过模型上下文协议（MCP）将 Ableton Live 连接到 Claude AI，允许 Claude 直接与 Ableton Live 交互并进行控制。此集成支持提示词辅助的音乐制作、轨道创建以及 Live 的 Session 控制。
## 功能
- **双向通信**：通过基于 Socket 的服务器将 Claude AI 连接到 Ableton Live
- **轨道操作**：创建、修改和操作 MIDI 及音频轨道
- **乐器与效果器选择**：Claude 可以从 Ableton 的资源库中访问并加载合适的乐器、效果器和声音
- **Clip 创建**：创建和编辑包含音符的 MIDI clip
- **Session 控制**：开始和停止播放、触发 clip 以及控制走带
## 组件
该系统由两个主要组件构成：
1. **Ableton Remote Script** (`Ableton_Remote_Script/__init__.py`)：Ableton Live 的 MIDI Remote Script，用于创建 Socket 服务器以接收和执行命令
2. **MCP Server** (`server.py`)：实现模型上下文协议并连接到 Ableton Remote Script 的 Python 服务器
## 安装说明
### 通过 Smithery 安装
要通过 [Smithery](https://smithery.ai/server/@ahujasid/ableton-mcp) 自动为 Claude Desktop 安装 Ableton Live 集成：
```
npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude
```
### 前置条件
- Ableton Live 10 或更新版本
- Python 3.8 或更新版本
- [uv 包管理器](https://astral.sh/uv)
如果您使用的是 Mac，请按以下方式安装 uv：
```
brew install uv
```
否则，请从 [uv 的官方网站][https://docs.astral.sh/uv/getting-started/installation/] 进行安装
⚠️ 在安装 uv 之前请不要继续后续步骤
### Claude for Desktop 集成
[跟随 setup 指导视频进行操作](https://youtu.be/iJWJqyVuPS8)
1. 前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json，添加以下内容：
```
{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": [
"ableton-mcp"
]
}
}
}
```
### Cursor 集成
通过 uvx 无需永久安装即可运行 ableton-mcp。前往 Cursor Settings > MCP，将此作为命令粘贴：
```
uvx ableton-mcp
```
⚠️ 仅运行一个 MCP 服务器实例（在 Cursor 或 Claude Desktop 中，不要同时运行两者）
### 安装 Ableton Remote Script
[跟随 setup 指导视频进行操作](https://youtu.be/iJWJqyVuPS8)
1. 从此 repo 下载 `AbletonMCP_Remote_Script/__init__.py` 文件
2. 将文件夹复制到 Ableton 的 MIDI Remote Scripts 目录。不同的操作系统和版本有不同的位置。**以下其中一个应该有效，您可能需要自己找一下**：
**对于 macOS：**
- 方法 1：前往 Applications > 右键点击 Ableton Live 应用 → Show Package Contents（显示包内容） → 导航至：
`Contents/App-Resources/MIDI Remote Scripts/`
- 方法 2：如果第一种方法找不到，请使用直接路径（将 XX 替换为您的版本号）：
`/Users/[用户名]/Library/Preferences/Ableton/Live XX/User Remote Scripts`
**对于 Windows：**
- 方法 1：
C:\Users\[用户名]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts
- 方法 2：
`C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\`
- 方法 3：
`C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\`
*注意：将 XX 替换为您的 Ableton 版本号（例如 10、11、12）*
3. 在 Remote Scripts 目录中创建一个名为 'AbletonMCP' 的文件夹，并将下载的 `__init__.py` 文件粘贴进去
4. 启动 Ableton Live
5. 前往 Settings/Preferences → Link, Tempo & MIDI
6. 在 Control Surface 下拉菜单中，选择 "AbletonMCP"
7. 将 Input 和 Output 设置为 "None"
## 使用方法
### 建立连接
1. 确保 Ableton Remote Script 已在 Ableton Live 中加载
2. 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置
3. 当您与 Claude 交互时，连接应自动建立
### 配合 Claude 使用
一旦在 Claude 上设置好配置文件，并且 remote script 在 Ableton 中运行，您将看到一个带有 Ableton MCP 工具的锤子图标。
## 功能特性
- 获取 Session 和轨道信息
- 创建和修改 MIDI 及音频轨道
- 创建、编辑和触发 clip
- 控制播放
- 从 Ableton 的浏览器中加载乐器和效果器
- 将音符添加到 MIDI clip
- 更改速度及其他 Session 参数
## 示例命令
以下是您可以要求 Claude 执行的一些示例：
- "Create an 80s synthwave track" [演示](https://youtu.be/VH9g66e42XA)
- "Create a Metro Boomin style hip-hop beat"
- "Create a new MIDI track with a synth bass instrument"
- "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"
## 常见问题排查
- **连接问题**：确保 Ableton Remote Script 已加载，并且 MCP 服务器已在 Claude 上配置
- **超时错误**：尝试简化您的请求，或将其拆分为较小的步骤
- **您试过关机再重启吗？**：如果仍有连接错误，请尝试同时重启 Claude 和 Ableton Live
## 技术细节
### 通信协议
该系统通过 TCP Socket 使用简单的基于 JSON 的协议：
- 命令以带有 `type` 和可选 `params` 的 JSON 对象形式发送
- 响应是带有 `status` 以及 `result` 或 `message` 的 JSON 对象
### 限制与安全考虑
- 创建复杂的音乐编排可能需要分解为较小的步骤
- 该工具专为配合 Ableton 的默认设备和浏览器项而设计
- 在进行大量实验之前，请务必保存您的工作
## 贡献
欢迎贡献！请随时提交 Pull Request。
## 免责声明
这是一个第三方集成，非由 Ableton 制作。
标签：Ableton Live, Ableton远程脚本, AI作曲, AI编曲, AI音乐, Claude AI, Claude Desktop, Clip操作, DAW, Homebrew安装, MCP, MIDI控制, MIDI轨操作, Model Context Protocol, Python, Smithery, Socket通信, uv包管理器, 双工通信, 大语言模型集成, 插件, 效果器, 数字音频工作站, 无后门, 智能家居, 脚本, 自动化控制, 辅助工具, 逆向工具, 音乐创作, 音乐制作, 音源加载, 音频工程, 音频轨操作