Ableton MCP Extended

通过自然语言控制 Ableton Live，借助 Claude 或 Cursor 等 AI 助手。本项目提供了一个强大的模型上下文协议（MCP）服务器，可将自然语言命令转换为 Ableton Live 会话中的精确操作。

带改进的分支。 新增了 22 个 Remote Script 命令和 25 个 MCP 工具： 读取 MIDI 音符、场景、session 片段属性、混音器（mute/solo/arm、发送）、 Wavetable 调制矩阵、undo/redo。 详情和安装说明见 FORK-NOTES.md。

视频演示：https://www.youtube.com/watch?v=7ZKPIrJuuKk

该工具专为制作人、开发者和 AI 爱好者设计，旨在简化音乐制作流程、尝试生成式音乐，并构建与 Ableton Live 的自定义集成。

您可以将这段对话：

👤 "Create a brief minimalist/neo-classical composition in a style similar to Ólafur Arnalds'. (Ableton MCP) / I've loaded four MIDI tracks called "Noire" and "Noire (2) ["Emotional Felt" presets], "Noire (2) ["Reversed Felt" preset, for ambient background], and "Noire (3) ["Ethereal Felt" preset, also for ambient background]. All loaded with nice piano instruments. You have also a MIDI track called "Strings" with a nice string ensemble instrument loaded. Feel free to add new instruments and effects, if pertinent."
🤖 "Creating MIDI clips... Adding effects... Done!"
👤 "Then, use ElevenLabs MCP to create a spoken-word audio clip (default voice and settings) with a relevant poem in the style of “Jim Morrison” to accompany the composition."  
🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"

转化为这样的音乐制作会话：

https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3

主要功能

本项目提供对 Ableton Live 环境的全面、可编程控制。

• 会话与走带控制：

  • 启动和停止播放。

  • 获取会话信息，包括速度、拍号和轨道数量。

  • 管理场景：创建、删除、重命名和触发。

• 轨道管理：

  • 创建、重命名并获取 MIDI 和音频轨道的详细信息。

  • 控制轨道属性：音量、声像、静音、独奏和预备录制。

  • 管理轨道编组和折叠状态。

• MIDI 片段与音符操作：

  • 创建并命名指定长度的 MIDI 片段。

  • 在片段内添加、删除、移调和量化音符。

  • 在单次操作中对多个音符进行批量编辑。

  • 调整片段循环参数和后续动作。

• 设备与参数控制：

  • 通过 URI 从 Ableton 浏览器加载乐器和效果器。

  • 获取轨道上任何设备的完整参数列表。

  • 使用归一化值（0.0 到 1.0）设置和批量设置设备参数。

• 自动化与包络：

  • 在片段内为任何设备参数添加和清除自动化点。[此功能尚不完全稳定。]

  • 获取现有片段包络的信息。

• 浏览器集成：

  • 浏览并列出 Ableton 浏览器中的项目。

  • 直接从浏览器路径或 URI 加载乐器、效果器和采样。

  • 将音频文件直接导入音频轨道或片段插槽。

• 语音与音频生成

  • 文本转语音集成：通过 ElevenLabs MCP [已包含] 生成旁白、人声采样或口语元素。

  • 自定义声音创建：为您的曲目克隆独特的声音角色。

  • 音效：使用 AI 创建自定义 SFX。

  • 直接导入：生成的音频即时出现在您的 Ableton 会话中。

• 可扩展的自定义工具框架

  • 示例：XY 鼠标控制器——演示如何使用 MCP 框架创建自定义 Ableton 控制器。

  • 超低延迟：高性能 UDP 协议支持响应式实时控制。

  • 无限可能：为 Ableton Live 构建您自己的自定义工具和控制器。

Related MCP server: io.github.peterkolbe/ableton-for-ai

快速开始（5 分钟）

前提条件

• Ableton Live 11+（任何版本）

• Python 3.10 或更高版本

• Claude Desktop 或 Cursor IDE

1. 获取代码

git clone https://github.com/uisato/ableton-mcp-extended.git
cd ableton-mcp-extended
pip install -e .

2. 安装 Ableton 脚本

1. 找到您的 Ableton 用户库 Remote Scripts 文件夹：

   • Windows：C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\

   • Mac：~/Music/Ableton/User Library/Remote Scripts/

2. 创建文件夹：AbletonMCP

3. 将 AbletonMCP_Remote_Script/__init__.py 复制到此文件夹中

3. 配置 Ableton

1. 打开 Ableton Live

2. 转到 Preferences → Link, Tempo & MIDI

3. 将 Control Surface 设置为 "AbletonMCP"

4. 将输入/输出设置为 "None"

4. 连接 AI 助手

对于 Claude Desktop：

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
    }
  }
}

对于 Cursor： 在 Settings → MCP 中添加 MCP 服务器，使用相同的路径。

5. 开始创作！

打开您的 AI 助手并尝试：

• "创建一个带钢琴的新 MIDI 轨道"

• "添加一个简单的鼓点"

• "我目前有哪些轨道？"

工作原理

graph TB
    A[You: Natural Language] --> B[AI Assistant]
    B --> C[MCP Server]
    C --> D[Ableton Remote Script]
    D --> E[Ableton Live API]
    E --> F[🎵 Your Music]
    
    G[ElevenLabs AI] --> H[Generated Audio]
    H --> C

1. 您用自然语言向 AI 助手发出命令（例如，“创建一个新的 MIDI 轨道并将其命名为‘Bass’”）。

2. AI 助手理解意图并调用 MCP 服务器中的相应工具。

3. MCP 服务器（server.py）接收工具调用并构建特定的 JSON 命令。

4. 在 Live 内部运行的 Ableton Remote Script（init.py）通过套接字连接接收 JSON 命令。

5. Remote Script 使用官方 Ableton Live API 执行命令，即时在您的会话中进行更改。

高级功能

用于超低延迟的实时参数控制：

# Install the hybrid server
cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/

# Try the XY Mouse Controller example
cd experimental_tools/xy_mouse_controller
python mouse_parameter_controller_udp.py

这演示了如何构建：

• 用于 Ableton 的自定义实时控制器

• 富有表现力的演奏工具

• 交互式音乐应用

此仓库可与其他 MCP 服务器（例如 ElevenLabs 的服务器）集成，以生成音频并直接导入您的项目。

按照其说明设置 ElevenLabs MCP 服务器。

更新您的 AI 助手配置以包含两个服务器。

示例 mcp-config.json：

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["/path/to/ableton-mcp-extended/server.py"]
    },
    "ElevenLabs": {
      "command": "python",
      "args": ["/path/to/elevenlabs_mcp/server.py"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

组件概述

本项目包含几个专门的组件：

核心 MCP 服务器

• 标准 TCP 通信，实现可靠的 AI 控制

• 广泛的 Ableton Live API 集成

• 兼容 Claude Desktop、Cursor 和 Gemini CLI。

混合 TCP/UDP 服务器

• 高性能实时参数控制

• 超低延迟，适合现场表演

• 非常适合控制器和交互式工具

ElevenLabs 集成

• 专业文本转语音生成

• 自定义声音创建和克隆

• 直接导入 Ableton 会话

• 实时 SFX 生成

实验性工具与示例

• XY 鼠标控制器：演示如何构建自定义 Ableton 控制器的示例

• 可扩展框架：为创建您自己的控制界面奠定基础

• 概念验证：展示 MCP 方法的强大和灵活性

文档

• 安装指南 - 详细的设置说明

• 用户指南 - 内容、对象和方法

社区与支持

• GitHub Issues：错误报告和功能请求

• 讨论：分享您的创作并获取帮助

分享您的创作

用您的 AI 生成实验标记我！我喜欢看到社区创作的内容：

YouTube | Instagram | Patreon | 网站

后续计划

• 修复自动化点放置错误

• VST 插件支持 - 控制第三方插件 [虽然可以通过“Configure”参数功能实现] → 已完成！

• Arrangement 视图 - 完整时间线控制

• 硬件集成 - 通过 AI 桥接 MIDI 控制器

• 高级 AI - 更智能、更好的音乐理解和生成

许可证与致谢

本项目根据 MIT 许可证授权 - 详情请参阅 LICENSE。

构建工具：

• Model Context Protocol - AI 集成框架

• ElevenLabs API - 专业语音生成

• Ableton Live - 数字音频工作站

灵感来源： 原始 ableton-mcp 项目

为音乐制作社区用心打造 ❤️

如果这个项目有助于您的创作，请考虑给它一个 ⭐ 星标！