ableton-copilot-mcp

ableton-copilot-mcp

site icon
2025.04.12 6
TypeScript音乐制作Ableton Live 控制娱乐功能
ableton-copilot-mcp 是一个基于 [ableton-js](https://github.com/leolabs/ableton-js) 的 MCP(Model Context Protocol)服务器,专为音乐制作人设计,用于实时与 Ableton Live 进行交互和控制,辅助音乐创作。
View on GitHub

Overview

基本能力

产品定位

ableton-copilot-mcp 是一个专为音乐制作人设计的工具,通过 MCP 协议与 Ableton Live 进行实时交互,提供歌曲控制、轨道管理、剪辑操作和音频操作等功能,帮助用户更高效地进行音乐创作。

核心功能

  1. 歌曲控制
  2. 获取歌曲基本信息(根音、音阶名称、速度、歌曲长度等)
  3. 获取所有轨道的列表
  4. 创建 MIDI、音频和返回轨道
  5. 删除和复制轨道

  6. 轨道管理

  7. 获取轨道中的所有剪辑
  8. 创建空的 MIDI 剪辑
  9. 设置轨道属性(静音、颜色、名称、启用、独奏等)
  10. 将 MIDI 剪辑复制到指定轨道

  11. 剪辑操作

  12. 获取钢琴卷视图中的剪辑
  13. 获取和管理剪辑中的所有音符
  14. 在剪辑中添加、删除和替换音符
  15. 设置剪辑属性(名称、颜色、循环、循环开始、循环结束等)

  16. 音频操作

  17. 支持基于时间范围录制轨道内容

适用场景

  • 音乐制作人在 Ableton Live 中进行实时创作和编辑
  • 需要自动化控制 Ableton Live 的场景
  • 通过外部工具(如 Cursor、Cherry Studio 等)与 Ableton Live 交互

工具列表

  1. Cursor:一个支持 MCP 协议的客户端,可以配置 ableton-copilot-mcp 进行交互。
  2. Cherry Studio:另一个支持 MCP 协议的客户端,可用于与 ableton-copilot-mcp 集成。
  3. Claude Desktop:支持 MCP 协议的客户端之一。

常见问题解答

  1. 兼容性
  2. 已测试支持 Ableton Live 12.1.10 版本。
  3. 11.x 和 10.x 版本尚未测试。
  4. 安装问题
  5. 确保 Node.js 和 npx 命令可用。
  6. 确保 AbletonJS Control Surface 在 Ableton Live 中启用。

使用教程

使用依赖

  1. 安装 Node.js:确保 npx 命令可用。建议从 Node.js 官网 安装最新稳定版本。
  2. 安装 MIDI Remote Scripts:按照 ableton-js 项目的说明,将 AbletonJS MIDI Remote Scripts 安装到 Ableton Live 中。

安装教程

  1. 确保 Ableton Live 已启动并运行。
  2. 在配置中启用 AbletonJS Control Surface:
  3. 路径:Settings -> Link, Tempo & MIDI -> MIDI -> Control Surface
  4. 使用 MCP 客户端(如 Cursor、Cherry Studio 或 Claude Desktop)连接。

调试方式

  1. 确保 Ableton Live 和 ableton-copilot-mcp 服务正常运行。
  2. 检查 AbletonJS Control Surface 是否已启用。
  3. 使用客户端工具(如 Cursor)进行连接测试。

Cursor 配置示例

"ableton-js-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "ableton-copilot-mcp"
    ]
}

许可证

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