Easy Ableton MCP
通过Claude或Cursor等人工智能助手使用自然语言控制Ableton Live。零配置安装-只需运行一个命令。
分叉通知： 这是一把叉子 uisato的ableton mcp延长。我无耻地窃取了他的大部分代码，并添加了自动安装、简化的TCP协议和懒惰的Ableton启动。核心MCP服务器和远程脚本的所有功劳都归uisato所有。
______________________________________________________________________
视频演示：https://www.youtube.com/watch?v=7ZKPIrJuuKk
该工具专为制作人、开发人员和人工智能爱好者设计，他们希望简化音乐制作工作流程，尝试生成音乐，并与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构建自己的自定义工具和控制器
______________________________________________________________________
快速入门（5分钟）
先决条件
- Ableton Live 11+（任何版本）
- Python 3.10或更高版本
- Claude桌面或光标IDE
1. 获取代码
git clone https://github.com/androidStern/easy-ableton-mcp.git
cd easy-ableton-mcp
pip install -e .2. 安装Ableton脚本
- 查找您的Ableton远程脚本文件夹：
- 视窗: C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\ - 苹果电脑: ~/Library/Preferences/Ableton/Live [Version]/User Remote Scripts/
- 创建文件夹：
AbletonMCP - 复制
AbletonMCP_Remote_Script/__init__.py放入此文件夹
3. 配置Ableton
- 打开Ableton直播
- 首选 偏好 → 链接、节奏和MIDI
- 集 控制表面 转到“AbletonMCP”
- 将输入/输出设置为“无”
4. 连接AI助手
对于Claude Desktop：
{
"mcpServers": {
"AbletonMCP": {
"command": "python",
"args": ["C:/path/to/easy-ableton-mcp/MCP_Server/server.py"]
}
}
}对于光标： 在设置中添加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- 你用简单的英语向你的AI助手发出命令（例如，“创建一个新的MIDI曲目并将其命名为‘Bass’”）。
- AI助手理解意图，并从MCP服务器调用相应的工具。
- MCP服务器（Server.py）接收工具调用并构造特定的JSON命令。
- Ableton远程脚本(__初始化__.py）在Live内部运行，通过套接字连接接收JSON命令。
- 远程脚本使用官方Ableton Live API执行命令，立即对您的会话进行更改。
______________________________________________________________________
高级功能
🚀 High-Performance Mode (UDP Server)
用于超低延迟的实时参数控制：
# 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的定制实时控制器
- 表达性绩效工具
- 交互式音乐应用程序
🎤 ElevenLabs Voice Integration
此存储库可以与其他MCP服务器集成，例如ElevenLabs的服务器，以直接生成音频并将其导入到您的项目中。
根据指示设置ElevenLabs MCP服务器。
更新你的AI助手的配置，以包括这两个服务器。
示例mcp-config.json：
{
"mcpServers": {
"AbletonMCP": {
"command": "python",
"args": ["/path/to/easy-ableton-mcp/server.py"]
},
"ElevenLabs": {
"command": "python",
"args": ["/path/to/elevenlabs_mcp/server.py"],
"env": {
"ELEVENLABS_API_KEY": "your-api-key-here"
}
}
}
}______________________________________________________________________
组件概览
该项目包括几个专门的组成部分：
核心MCP服务器
- 用于可靠AI控制的标准TCP通信
- 广泛的Ableton Live API集成
- 与Claude Desktop、Cursor和Gemini CLI兼容。
TCP/UDP混合服务器
- 高性能实时参数控制
- 超低延迟，实现现场表演
- 非常适合控制器和交互式工具
ElevenLabs集成
- 专业的文本到语音生成
- 自定义语音创建和克隆
- 直接导入Ableton会话
- 实时SFX生成
实验工具和示例
- XY鼠标控制器：演示如何构建自定义Ableton控制器的示例
- 可扩展框架：创建自己的控制接口的基础
- 概念验证：展示了MCP方法的力量和灵活性
______________________________________________________________________
文档
______________________________________________________________________
社区与支持
- GitHub问题：Bug报告和功能请求
- 讨论：分享您的创作并获得帮助
分享你的创意
用你的人工智能生成实验来标记我！我喜欢看到社区创造的东西：
______________________________________________________________________
接下来是什么
- 修复自动化点放置错误
- VST插件支持 -控制第三方插件\[虽然可以通过“配置”参数功能实现\]
- 排列视图 -完整的时间线控制
- 硬件集成 -通过AI桥接MIDI控制器
- 先进的人工智能 -更智能、更好的音乐理解和生成
______________________________________________________________________
许可证和信用证
此项目根据MIT许可证获得许可-请参阅 许可证 了解详情。
内置：
- 模型上下文协议 -人工智能集成框架
- ElevenLabs API -专业语音生成
- Ableton现场 -数字音频工作站
灵感来源： 原版 艾博顿mcp 项目
______________________________________________________________________
由以下材料制成❤️ 为音乐制作界
*如果这个项目有助于你的创造力，考虑给它一个⭐ 明星*