AbletonMCP - Ableton Live Model Context Protocol Integration

AbletonMCP - Ableton Live Model Context Protocol Integration

site icon
2025.03.27 1365
Python音乐制作AI 辅助创作娱乐功能
AbletonMCP 是一个通过 Model Context Protocol (MCP) 将 Ableton Live 与 Claude AI 连接的工具,允许 Claude 直接与 Ableton Live 交互并控制其功能。该集成支持通过提示辅助音乐制作、轨道创建和 Live 会话操作。
View on GitHub

Overview

基本能力

产品定位

AbletonMCP 是一个音乐制作辅助工具,通过 AI 集成提升音乐创作的效率和创意。

核心功能

  • 双向通信:通过基于套接字的服务器连接 Claude AI 和 Ableton Live
  • 轨道操作:创建、修改和操作 MIDI 和音频轨道
  • 乐器和效果选择:Claude 可以访问和加载 Ableton 库中的乐器和效果
  • 片段创建:创建和编辑带有音符的 MIDI 片段
  • 会话控制:开始和停止播放、触发片段和控制传输

适用场景

  • 音乐制作和创作
  • AI 辅助音乐生成
  • 音乐教育和实验

工具列表

  1. Ableton Remote Script:一个 MIDI 远程脚本,用于 Ableton Live,创建套接字服务器接收和执行命令
  2. MCP Server:一个 Python 服务器,实现 Model Context Protocol 并连接到 Ableton Remote Script

常见问题解答

  • 连接问题:确保 Ableton Remote Script 已加载,且 MCP 服务器已在 Claude 中配置
  • 超时错误:尝试简化请求或将其分解为更小的步骤
  • 重启建议:如果仍有连接错误,尝试重启 Claude 和 Ableton Live

使用教程

使用依赖

  • Ableton Live 10 或更新版本
  • Python 3.8 或更新版本
  • uv 包管理器

在 Mac 上安装 uv:

brew install uv

其他平台请参考 uv 官方文档

安装教程

通过 Smithery 自动安装:

npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude

调试方式

  1. 确保 Ableton Remote Script 已在 Ableton Live 中加载
  2. 确保 MCP 服务器已在 Claude Desktop 或 Cursor 中配置
  3. 连接应在与 Claude 交互时自动建立

技术细节

通信协议

系统使用基于 JSON 的简单协议通过 TCP 套接字进行通信: - 命令作为带有 type 和可选 params 的 JSON 对象发送 - 响应是带有 statusresultmessage 的 JSON 对象

限制与安全考虑

  • 创建复杂的音乐编排可能需要分解为更小的步骤
  • 该工具设计用于与 Ableton 的默认设备和浏览器项目一起工作
  • 在进行大量实验之前始终保存您的工作

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。