AbletonMCP - 集成 Ableton Live 模型上下文协议 (Model Context Protocol)
ahujasid/ableton-mcp
main BranchesTags Go to file Code
Folders and files
Name| Name| Last commit message| Last commit date
---|---|---|---
Latest commit
History
23 Commits
AbletonMCP_Remote_Script| AbletonMCP_Remote_Script
MCP_Server| MCP_Server
.gitignore| .gitignore
.python-version| .python-version
Dockerfile| Dockerfile
LICENSE| LICENSE
README.md| README.md
pyproject.toml| pyproject.toml
smithery.yaml| smithery.yaml
uv.lock| uv.lock
View all files
Repository files navigation
AbletonMCP - Ableton Live Model Context Protocol Integration
AbletonMCP 通过模型上下文协议 (MCP) 将 Ableton Live 连接到 Claude AI,从而使 Claude 能够直接与 Ableton Live 交互并对其进行控制。这种集成支持提示辅助音乐制作、音轨创建和 Live 会话操作。
加入社区
提供反馈、获得灵感,并在 MCP 的基础上进行构建:Discord。由 Siddharth 制作
功能
- 双向通信 : 通过基于 socket 的服务器将 Claude AI 连接到 Ableton Live
- 音轨操作 : 创建、修改和操作 MIDI 和音频音轨
- 乐器和效果选择 : Claude 可以从 Ableton 的库中访问和加载正确的乐器、效果和声音
- 片段创建 : 创建和编辑带有音符的 MIDI 片段
- 会话控制 : 启动和停止播放、触发片段并控制传输
组件
- Ableton Remote Script (
Ableton_Remote_Script/__init__.py): 用于 Ableton Live 的 MIDI Remote Script,它创建一个 socket 服务器来接收和执行命令 - MCP Server (
server.py): 一个 Python 服务器,它实现了模型上下文协议并连接到 Ableton Remote Script
安装
通过 Smithery 安装
要通过 Smithery 为 Claude Desktop 自动安装 Ableton Live 集成,请执行以下操作:
npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude
前提条件
- Ableton Live 10 或更高版本
- Python 3.8 或更高版本
- uv package manager
如果您使用的是 Mac,请按以下方式安装 uv:
brew install uv
否则,从 [uv 官方网站][https://docs.astral.sh/uv/getting-started/installation/] 安装 ⚠️ 在安装 UV 之前不要继续
Claude for Desktop 集成
- 转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 以包含以下内容:
{
"mcpServers": {
"AbletonMCP": {
"command": "uvx",
"args": [
"ableton-mcp"
]
}
}
}
Cursor 集成
无需通过 uvx 永久安装即可运行 ableton-mcp。转到 Cursor 设置 > MCP 并粘贴此作为命令:
uvx ableton-mcp
⚠️ 仅运行一个 MCP 服务器实例(无论是在 Cursor 还是 Claude Desktop 上),而不是两者都运行
安装 Ableton Remote Script
- 从此 repo 下载
AbletonMCP_Remote_Script/__init__.py文件 - 将文件夹复制到 Ableton 的 MIDI Remote Scripts 目录。不同的操作系统和版本有不同的位置。以下方法之一应该有效,您可能需要查找 :
对于 macOS:
- 方法 1:转到应用程序 > 右键单击 Ableton Live 应用程序 → 显示包内容 → 导航到:
Contents/App-Resources/MIDI Remote Scripts/ - 方法 2:如果第一种方法中没有,请使用直接路径(将 XX 替换为您的版本号):
/Users/[Username]/Library/Preferences/Ableton/Live XX/User Remote Scripts对于 Windows: - 方法 1:C:\Users[Username]\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)
- 方法 1:转到应用程序 > 右键单击 Ableton Live 应用程序 → 显示包内容 → 导航到:
- 在 Remote Scripts 目录中创建一个名为 'AbletonMCP' 的文件夹,然后粘贴下载的 'init.py' 文件
- 启动 Ableton Live
- 转到设置/偏好设置 → Link, Tempo & MIDI
- 在 Control Surface 下拉列表中,选择“AbletonMCP”
- 将输入和输出设置为“无”
用法
启动连接
- 确保 Ableton Remote Script 已加载到 Ableton Live 中
- 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置
- 当您与 Claude 交互时,连接应会自动建立
与 Claude 一起使用
在 Claude 上设置配置文件并且 remote script 在 Ableton 中运行后,您将看到一个带有 Ableton MCP 工具的锤子图标。
功能
- 获取会话和音轨信息
- 创建和修改 MIDI 和音频音轨
- 创建、编辑和触发片段
- 控制播放
- 从 Ableton 的浏览器加载乐器和效果
- 将音符添加到 MIDI 片段
- 更改速度和其他会话参数
示例命令
- “创建一首 80 年代的 synthwave 音轨” Demo
- “创建一个 Metro Boomin 风格的嘻哈节拍”
- “使用合成贝斯乐器创建一个新的 MIDI 音轨”
- “为我的鼓添加混响”
- “创建一个包含简单旋律的 4 小节 MIDI 片段”
- “获取有关当前 Ableton 会话的信息”
- “将 808 鼓机架加载到选定的音轨中”
- “在音轨 1 中的片段中添加爵士和弦进行”
- “将速度设置为 120 BPM”
- “播放音轨 2 中的片段”
故障排除
- 连接问题 : 确保 Ableton Remote Script 已加载,并且 MCP 服务器已在 Claude 上配置
- 超时错误 : 尝试简化您的请求或将其分解为更小的步骤
- 您是否尝试过重新启动? : 如果您仍然遇到连接错误,请尝试重新启动 Claude 和 Ableton Live
技术细节
通信协议
该系统使用基于 TCP socket 的简单 JSON 协议:
- 命令作为 JSON 对象发送,其中包含
type和可选的params - 响应是 JSON 对象,其中包含
status和result或message
限制和安全注意事项
- 创建复杂的音乐编排可能需要分解为更小的步骤
- 该工具旨在与 Ableton 的默认设备和浏览器项目一起使用
- 在进行大量实验之前,请务必保存您的作品
贡献
免责声明
关于
未提供描述、网站或主题。
资源
License
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published
Contributors 3
Languages
Footer
Footer navigation
You can’t perform that action at this time.