内容
<!-- mcp-name: io.github.wstierhout/ableton-live-mcp -->
# Ableton Live MCP 服务器
[](https://github.com/wstierhout/ableton-live-mcp/actions/workflows/ci.yml)
[](https://github.com/wstierhout/ableton-live-mcp/releases)
[](LICENSE)
[](pyproject.toml)
[](https://glama.ai/mcp/servers/wstierhout/ableton-live-mcp)
**网站和安装指南： [abletonmcp.com](https://abletonmcp.com)**
通过 AI 助手控制 Ableton Live。这是一个模型上下文协议（MCP）服务器，为 Claude、Cursor、Codex 或任何 MCP 客户端提供 154 种工具，用于构建音轨、编辑 MIDI、加载乐器和效果、混音和母带处理， 以及在运行的 Ableton Live 会话中，或离线读取和差异化保存的 `.als` 项目文件。
一个远程脚本在 Live 中运行，并通过本地套接字公开 Live API。MCP 服务器将其转换为键入的、验证过的工具，AI 可以正确调用这些工具，并提供每个工具的文档、只读和破坏性提示，以及工作流提示。
## 快速入门
您需要 Ableton Live 11 或 12、Python 3.10+ 和 [uv](https://docs.astral.sh/uv/) (`brew install uv`)。
**1. 注册 MCP 服务器。**
Claude 代码：
```bash
claude mcp add AbletonMCP -s user -- uvx mcp-server-ableton-live
```
Claude 桌面版或 Cursor，在配置文件中的 `mcpServers` 块中：
```json
{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": ["mcp-server-ableton-live"]
}
}
}
```
（要运行未发布的修订版，请使用 `uvx --from git+https://github.com/wstierhout/ableton-live-mcp ableton-live-mcp`。）
**2. 安装远程脚本。** 这会将 Live 端的脚本复制到您的用户库中：
```bash
uvx mcp-server-ableton-live install
```
然后重启 Live 并将设置 > Link/Tempo/MIDI > 控制表面设置为 `AbletonMCP`（输入和输出：无）。在升级软件包后再次运行安装程序，以确保 Live 端的脚本保持版本匹配。请参阅 Ableton 的[第三方远程脚本指南](https://help.ableton.com/hc/en-us/articles/209072009-Installing-third-party-remote-scripts)，如果该条目不出现。
**3. 检查设置。**
```bash
uvx mcp-server-ableton-live doctor
```
**4. 请求音乐。** 例如：”以 80 BPM 的速度制作一个 lofi 节拍，搭配一个尘土飞扬的鼓套件、一把直立贝斯和 Rhodes 和弦，然后在主音轨上添加一个限幅器，音量为 -1 dB。“
## 功能
| 领域 | 工具 |
|---|---|
| 会话和传输 | 会话信息，一键会话快照，播放/停止，速度，敲击速度，时间签名，循环，定位器和导航，场景，撤销/重做，捕捉 MIDI，歌曲音阶，整体律动和摆动，Ableton Link |
| 音轨和混音器 | 创建和删除 MIDI、音频和返回音轨；删除设备；取样通道；分组音轨折叠；音量、声像、静音、独奏、武装、发送；输入/输出路由；音量表 |
| 音片和音符 | 创建音片，编写和编辑 MIDI 音符（带有概率），量化强度，Groove Pool 摆动，循环，增益，音高，扭曲模式 |
| 设备 | 按名称浏览和搜索，在任何音轨（包括主音轨和返回音轨）上加载乐器和效果，读取和设置任何参数，侧链路由，样本预览，机架宏变量，Simpler 样本切片，每个垫的鼓控制，精选的设备知识库 |
| 排列 | 将音片放在时间轴上，读取和删除排列音片，写入音片自动化 |
| 生成器 | 7 种风格的鼓模式，欧几里得节奏，和弦进行，语音引导的爵士语调，50 多种基于流派的进行，语音引导的旋律，行走的贝斯线，主题变换（逆转，逆序，扩展），极简主义过程，人性化，一键会话设置 |
| 批量 | 在一次往返和一次撤销步骤中运行许多编辑 |
| 音频和分析 | 将某个部分录制为 WAV 文件，无需导出对话框，检测音调和音阶，扫描混音中的问题，差异化自上次检查的会话 |
| 离线（无 Live） | 总结，列出音轨，提取 MIDI，检测音调，读取混音器和定位器详细信息，差异化两个版本，检查保存的 `.als`，解析 `.adg`/`.adv` 机架并检测编辑 |
| 配方 | 以一个调用构建一个流派启动器（lofi，house） |
此外，还有五个工作流提示（`make_a_beat`，`mix_and_master`，`start_a_track`，`sound_design`，`analyze_and_improve`）和一组服务器指令，用于在第一次调用之前向模型教授约定：
0 基数索引，拍子表示时间，0.85 音量等于 0 dB，以及设备的原生范围。
## 注意事项
每个操作都是具有验证参数的特定工具；没有任意代码路径。某些工具仍然会进行破坏性编辑（删除音轨，替换音片的音符，重写排列区域），因此请在进行大型会话之前保存您的工作。
## 聚焦工具集
服务器注册了 154 种工具。对于一个小型任务来说，这对模型来说太多了。设置 `ABLETON_TOOLSETS` 以仅加载所需的组，例如 `ABLETON_TOOLSETS=session,tracks,clips,generators`。组（每个组可能跨多个模块）：`session`，`tracks`，`clips`，`devices`，`browser`，`arrangement`，`generators`，`audio`，`analysis`，`offline`，`recipes`。取消设置会加载所有内容。
## 约定
- 索引基于 0。时间和长度以拍子为单位。音量使用 Live 的 0.0 至 1.0 滑动范围，其中 0.85 为 0 dB。
- 设备参数使用每个参数自己的范围。首先读取 `get_device_parameters` 并在设置前检查最小值、最大值和显示值。
- `add_notes_to_clip` 替换音片的音符。使用 `edit_notes` 添加或删除几个音符而不触及剩余的音符。
- 将会话音片放入排列中会覆盖其下方的任何内容，这也是替换某个部分的方法。
- 传输回复报告命令运行前的状态。与 `get_session_info` 确认。
## 故障排除
- `AbletonMCP` 在控制表面列表中缺失：文件夹必须命名为 `AbletonMCP`，并且 Live 仅在启动时扫描脚本，因此请重启它。
- 每个命令都超时：一个对话框在 Live 中打开，它阻止了脚本。在试用版中，这是启动时的 nags。关闭它并重试。
- 9877 端口未监听：Live 未运行，或控制表面未设置。如果另一个程序已经使用 9877，请在 Live 的启动环境中设置 `ABLETON_MCP_PORT`，并为服务器设置 `ABLETON_PORT`，以使双方匹配。
- 您无法从工具导出或冻结：Live 的 API 没有渲染或冻结功能，因此这些操作仍需手动执行。对于渲染音频，请使用快捷方式导出并单独分析文件。
## 安全
远程脚本在 `127.0.0.1:9877` 上监听，没有身份验证。它绑定到环回地址，因此只有本地进程可以访问它。不要转发该端口或将绑定地址更改为公共接口。请参阅 [SECURITY.md](SECURITY.md)。
## 开发
```bash
ableton_live_mcp/
server.py 入口点：运行 MCP 服务器或设置子命令
app.py FastMCP 应用程序、生命周期和服务器指令
connection.py 到远程脚本的套接字客户端
cli.py 安装/卸载/医生子命令
tools/ 会话、音轨、音片、设备、浏览器、排列、生成器、提示
remote_script/
__init__.py Live 端脚本及其命令调度表
tests/ 协议、调度合约和注册测试
```
```bash
uv run --extra dev pytest # 测试
uvx ruff check . # 检查代码风格
```
CI 运行代码风格检查、远程脚本的字节编译和 Python 3.10、3.12、3.13 和 3.14 上的测试。
## 常见问题
### 什么是 Ableton Live MCP 服务器？
它是一个本地模型上下文协议服务器，允许诸如 Claude、Cursor 和 Codex 之类的 AI 客户端通过键入的工具检查和控制 Ableton Live。它可以构建音轨、编辑 MIDI、加载和配置设备、排列音片、混音一个集合，并分析保存的 `.als` 项目。
### 这与其他的 Ableton MCP 服务器有什么不同？
该服务器公开了 154 个特定的、经过验证的工具，而不是任意的代码执行工具。它包括破坏性/只读提示、工作流提示、内置音乐生成器、混音和分析和离线 `.als`/`.adg` 检查。远程脚本和 MCP 包一起版本化和测试。
### 它可以在 Ableton Live 关闭时工作吗？
实时控制工具需要 Ableton Live 和捆绑的远程脚本才能运行。离线工具可以总结、检查、检查、提取 MIDI、检测音调、读取混音器和定位器详细信息、差异化两个版本、检查保存的 `.als`、`.adg` 和 `.adv` 文件，而无需启动 Live。
### 支持哪些 MCP 客户端？
任何可以启动本地 stdio MCP 服务器的客户端都可以使用它，包括 Claude 桌面版、Claude 代码、Cursor、Codex 和兼容的 IDE。规范命令是 `uvx mcp-server-ableton-live`。
### 这是官方 Ableton 产品吗？
不。它是一个独立的、开源的集成，不隶属于 Ableton，也不被 Ableton 认可。
## 致谢和许可证
MIT 许可证，由 [Wouter Stierhout](https://github.com/wstierhout) 维护。参见 `LICENSE`。Ableton 和 Live 是 Ableton AG 的商标。本独立开源项目不隶属于 Ableton AG，也不被 Ableton AG 认可。
