Ableton Live控制协议服务器

Ableton MCP是一个用于控制Ableton Live的服务器,支持查询音轨、分析会话和通过AI助手导出音轨。

  • by Dysron
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Dysron/ableton-mcp

使用说明

Ableton MCP

用于控制Ableton Live的MCP(模型上下文协议)服务器。通过Claude等人工智能助手进行查询跟踪、分析会话和导出词干。

仅限macOS -使用AppleScript实现GUI自动化。

特性

查询工具

  • test_connection -验证Ableton Live和AbletonOSC是否正在运行
  • list_tracks -列出所有带有可选剪辑计数的曲目
  • list_groups -列出所有组/文件夹曲目
  • get_track_info -获取特定曲目的详细信息
  • find_track -按名称搜索曲目

控制工具

  • select_track_by_index -在Live中选择曲目
  • set_export_range -设置导出的循环/冲压范围

导出工具(仅限macOS)

  • prepare_track_for_export -从剪辑中选择曲目并设置范围
  • export_selected_track -通过GUI自动化触发导出

需求

  • macOS(用于导出功能)
  • Python 3.10+
  • Ableton Live 11+ AbletonOSC 安装
  • 终端/Python的可访问权限(用于导出)

安装

1.安装AbletonOSC

cd ~/Downloads
git clone https://github.com/ideoforms/AbletonOSC.git
cp -r AbletonOSC ~/Music/Ableton/User\ Library/Remote\ Scripts/

然后在Ableton Live中:

  1. 首选项>链接/节奏/MDI
  2. 控制界面>选择“AbletonOSC”

2.安装ableton mcp

cd ~/mcps/src/ableton-mcp
pip install -e .

3.配置克劳德桌面

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ableton": {
      "command": "python",
      "args": ["-m", "server"],
      "cwd": "/path/to/ableton-mcp"
    }
  }
}

4.授予无障碍权限(用于导出)

系统首选项>隐私和安全>辅助功能>添加终端(或您的Python环境)

使用示例

"List all tracks in my Ableton session"
"Find tracks containing 'bass'"
"Prepare track 57 for export"
"Export the selected track"

建筑

┌─────────────┐       OSC        ┌─────────────┐
│  MCP Server │ ───────────────▶ │  Ableton    │
│  (FastMCP)  │ ◀─────────────── │  Live       │
└─────────────┘    port 11000    └─────────────┘
       │
       │ AppleScript (export only)
       ▼
┌─────────────┐
│  GUI Auto   │
│  (macOS)    │
└─────────────┘

局限性

  • 导出仅适用于macOS -使用AppleScript实现GUI自动化
  • 导出需要访问权限
  • 每次直播开始时都必须启用AbletonOSC

学分

许可证

麻省理工学院