Ableton Live MCP Server

Ableton Live MCP Server

网站和安装指南：abletonmcp.com

通过 AI 助手控制 Ableton Live。这是一个 Model Context Protocol（MCP）服务，为 Claude、Cursor、Codex 或任何 MCP 客户端提供 156 个工具，可在运行中的 Ableton Live 乐曲中创建轨道、编辑 MIDI、加载乐器和效果、混音及母带处理；此外还提供离线工具，可在 Live 关闭时读取和比较已保存的 .als 项目文件。

Remote Script 在 Live 内部运行，并通过本地套接字公开 Live API。MCP 服务将其转换为带类型且经过验证的工具，供 AI 正确调用；每个工具都附有文档、只读和破坏性操作提示，以及工作流提示词。

快速入门

你需要 Ableton Live 11 或 12、Python 3.10+ 和 uv（brew install uv）。

1. 注册 MCP 服务。

Codex（本地桌面应用、命令行或 IDE 宿主）：

codex mcp add ableton -- uvx [email protected]
codex mcp list

手动配置和故障排查请参阅 Codex 指南。

Claude Code：

claude mcp add AbletonMCP -s user -- uvx [email protected]

Claude Desktop 或 Cursor：在配置文件的 mcpServers 块中添加：

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "uvx",
      "args": ["[email protected]"]
    }
  }
}

（若要运行尚未发布的修订版本，请改用 uvx --from git+https://github.com/wstierhout/ableton-live-mcp ableton-live-mcp。）

2. 安装 Remote Script。 这会将 Live 端脚本复制到你的 User Library：

uvx [email protected] install

然后在 Live 中启用桥接：

1. 完全重启 Ableton Live。
2. 打开 Settings > Tempo & MIDI，找到 MIDI 部分中的 Control Surface 列表。
3. 在未使用的 Control Surface 行中选择 AbletonMCP。不要更改现有硬件控制器所在的行。
4. 在同一行中，将 Input: None 和 Output: None 设为对应选项。

在当前版本的 Live 中，Link 位于单独的 Settings 页面。旧版本中，请在 Settings/Preferences 下查找 Link, Tempo & MIDI（或 Link/MIDI），然后找到 MIDI 部分。

每个 MCP 客户端都必须进行此项选择。安装操作会复制 Remote Script；选择 Control Surface 则会在 Live 内启动脚本。桥接使用本地套接字，因此其所在行不需要硬件 MIDI 输入/输出端口。

升级软件包后，请再次运行安装程序，以确保 Live 端脚本与软件包版本一致。如果列表中未显示该项，请参阅 Ableton 的第三方 Remote Scripts 安装指南。

3. 检查设置。

uvx [email protected] doctor --json

如果你的资源库位置已变更，安装和 doctor 命令都使用相同的 --user-library "/path/to/User Library"。如果存在旧版或不同的脚本，安装会停止：请先检查，再添加 --replace。系统会保留一个唯一备份。开始诊断前请重启 Live；doctor 会检查已安装的字节内容和正在运行的桥接版本。

4. 从只读操作开始。 先询问节奏和轨道名称，不要进行任何更改。然后在一个临时乐曲中尝试：“以 80 BPM 制作一段 lo-fi 节拍，使用带有复古音色的鼓组、立式贝斯和 Rhodes 和弦，然后在主轨上添加一个限制器，并设为 -1 dB。”

功能

类别	工具
会话与传输	会话信息、一次调用获取会话快照、播放/停止、速度、敲击定速、拍号、循环、定位标记和提示导航、场景、撤销/重做、录制 MIDI、歌曲音阶、全局律动与摇摆、Ableton Link
音轨与混音器	创建和删除 MIDI、音频及返回音轨；删除设备；录音通道；折叠分组音轨；音量、声像、静音、独奏、录音准备、发送；输入/输出路由；电平表
片段与音符	创建片段、写入和编辑 MIDI 音符（含概率）、按强度量化、律动池摇摆、循环、增益、音高、变形模式
设备	按名称浏览和搜索；将乐器和效果器加载到任意音轨（包括 Master 和 Returns）；读取和设置任意参数；侧链路由、采样预览、机架宏变化、Simpler 采样切片、逐打击垫控制、精选设备知识库
编曲	在时间线上放置片段、读取和删除编曲片段、编写片段自动化
生成器	7 种风格的鼓组模式、欧几里得节奏、和弦进行、声部引导的爵士和弦、50 多种适配流派的和弦进行、声部引导旋律、行走贝斯线、动机变换（倒置、逆行、扩增）、极简主义流程、人性化处理、一次调用设置会话
批处理	在一次往返调用和一个撤销步骤中执行多项编辑
音频与分析	无需打开 Export 对话框即可将一段内容录制为 WAV、检测调性和音阶、扫描混音问题、比较自上次检查以来的会话变化
离线（无需 Live）	汇总、列出音轨、提取 MIDI、检测调性、读取混音器和定位标记详情、比较两个版本、检查已保存的 .als，以及解析 .adg/.adv 机架并检测版本
配方	一次调用即可搭建流派入门工程（lofi、house）

此外，还有 5 个工作流提示词（make_a_beat、mix_and_master、start_a_track、 sound_design、analyze_and_improve），以及一组服务器指令，会在模型首次调用前教会它相关约定： 索引从 0 开始、时间单位为拍、音量 0.85 等于 0 dB，以及设备参数的原生范围。

注意事项

每项操作都是具有经过验证参数的特定工具；没有任意代码执行途径。有些工具仍会进行破坏性编辑（删除音轨、替换片段的音符、覆盖编曲区域），因此在进行大型会话编辑前请先保存工作。

音频分析与会话变更

analyze_audio_file 可在本地读取 WAV（整数和浮点）、AIFF/AIFF-C、FLAC、 Ogg Vorbis、MP3、AAC 和 M4A/MP4（AAC 或 Apple Lossless）。该软件包会安装 PyAV 解码器依赖。它会保留文件、采样率、声道布局和浮点余量；压缩文件会在解码后进行测量。 默认分析前 30 秒（最多 120 秒，处理预算为 3,200 万个采样点），并在结果为部分数据时报告。 测量指标包括采样峰值和 RMS，不包括 LUFS 或真峰值。

session_diff 使用运行中的桥接程序提供的标识符区分重命名、重新排序和重名音轨。 请在编辑前后调用它；首次调用会建立比较基准。安装更新后的 Remote Script 并 重启 Live，可使桥接程序的快照格式与服务端保持一致。

精简工具集

服务端注册了 156 个工具。对于小任务来说，可供模型选择的工具太多。设置 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 确认。

故障排除

• “Control Surface”列表中没有 AbletonMCP：文件夹必须命名为 AbletonMCP，而且 Live 只会在启动时扫描脚本，因此请重启 Live。
• 每条命令都超时：Live 中有对话框处于打开状态，阻塞了脚本。试用版中，这是启动时的提示框。关闭后重试。
• 端口 9877 未在监听：Live 未运行，或尚未设置 Control Surface。如果其他程序已占用 9877，请在 Live 的启动环境中设置 ABLETON_MCP_PORT，并为服务设置 ABLETON_PORT，确保两端一致。
• 无法通过工具导出或冻结：Live 的 API 没有渲染或冻结功能，因此这些操作仍需手动完成。要渲染音频，请使用快捷键导出，再单独分析文件。

安全

Remote Script 在 127.0.0.1:9877 上监听，且不进行身份验证。它绑定到环回地址，因此只有本地进程可以访问。请勿转发该端口，也不要将绑定地址更改为公共接口。请参阅 SECURITY.md。

开发

ableton_live_mcp/
  server.py        entrypoint: runs the MCP server or a setup subcommand
  app.py           FastMCP app, lifecycle, and server instructions
  connection.py    socket client to the Remote Script
  cli.py           install / uninstall / doctor subcommands
  tools/           session, tracks, clips, devices, browser, arrangement,
                   generators, prompts
  remote_script/
    __init__.py    the Live-side script and its command dispatch tables
tests/             protocol, dispatch-contract, and registration tests

uv run --extra dev pytest      # tests
uvx ruff check .               # lint

CI 会运行 lint、Remote Script 的字节编译，以及在 Python 3.10、3.12、3.13 和 3.14 上运行的测试。

常见问题

Ableton Live MCP Server 是什么？

这是一个本地 Model Context Protocol 服务，让 Claude、Cursor 和 Codex 等 AI 客户端通过类型化工具检查和控制 Ableton Live。它可以创建轨道、编辑 MIDI、加载和配置设备、编排片段、混音，并分析已保存的 .als 项目。

这与其他 Ableton MCP 服务有何不同？

该服务提供 156 个经过验证的专用工具，而非任意代码执行工具。它包含破坏性操作和只读操作提示、工作流提示词、内置音乐生成器、混音和分析工具，以及离线 .als/.adg 检查功能。Remote Script 和 MCP 软件包采用相同的版本管理，并经过协同测试。

Ableton Live 关闭时也能使用吗？

实时控制工具需要 Ableton Live 和随附的 Remote Script 正在运行。离线工具无需启动 Live，即可汇总、检查、lint、提取 MIDI，以及比较已保存的 .als、.adg 和 .adv 文件。

支持哪些 MCP 客户端？

任何能够启动本地 stdio MCP 服务的客户端都可以使用，包括 Claude Desktop、Claude Code、Cursor、Codex 和兼容的 IDE。标准命令为 uvx mcp-server-ableton-live。

这是 Ableton 的官方产品吗？

不是。这是一项独立的开源集成项目，与 Ableton 无关联，也未获 Ableton 背书。

致谢与许可证

采用 MIT 许可证，由 Wouter Stierhout 维护。请参阅 LICENSE。Ableton 和 Live 是 Ableton AG 的商标。本独立开源项目与 Ableton AG 无关联，也未获其背书。