Able Osc MCP

AbleOscMcp

控制传输、创建和编辑MIDI剪辑、操纵曲目和设备以及订阅实时属性更改——所有这些都可以从Claude Desktop、Cursor或任何其他MCP客户端完成。

先决条件

• Ableton现场 10或更晚
• AbletonOSC 作为远程脚本安装(下面的设置指南)
• Python 3.11+ （通过 紫外线 推荐）

安装

# Install with uv (recommended)
uvx ableosc-mcp

# Or install with pip
pip install ableosc-mcp

AbletonOSC设置

AbletonOSC是一个免费的远程脚本，运行在Ableton Live内部，并通过OSC/UDP公开其Python API。

1. 从下载最新版本 视频/AbletonOSC
2. 复制 AbletonOSC 文件夹到您的Ableton用户库：

- macOS： ~/Music/Ableton/User Library/Remote Scripts/ - 窗户： C:\Users\\Documents\Ableton\User Library\Remote Scripts\

1. 完全退出并重新启动Ableton Live
2. 在阿布莱顿： 偏好→ 链接、节奏和MIDI→ 控制表面 → 选择 AbletonOSC

AbletonOSC监听UDP端口 11000 并在端口上回复 11001.

Claude桌面配置

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ableton": {
      "command": "uvx",
      "args": ["ableosc-mcp"]
    }
  }
}

或者，如果你已经克隆了repo：

{
  "mcpServers": {
    "ableton": {
      "command": "uv",
      "args": ["run", "ableosc-mcp"],
      "cwd": "/path/to/AbleOscMcp"
    }
  }
}

可用工具

歌曲/交通

轨迹

片段

设备

场景

查看/选择

实时听众

订阅Live属性更改并轮询更新——不需要轮询循环。

示例——观看节奏变化：

subscribe("tempo", level="song")
→ {"sub_id": "sub_3607efaa", "status": "subscribed"}

# AbletonOSC immediately sends current value:
poll("sub_3607efaa", timeout_seconds=0)
→ {"events": [{"value": 120}]}

# Change tempo in Ableton, then:
poll("sub_3607efaa", timeout_seconds=10)
→ {"events": [{"value": 128}]}

unsubscribe("sub_3607efaa")

您可以收听的属性：

环境变量

发展

git clone https://github.com/mawaha/AbleOscMcp
cd AbleOscMcp
uv sync --all-extras

# Unit tests (no Ableton needed)
uv run pytest tests/unit/ -v

# Integration tests (requires Ableton Live + AbletonOSC running)
# Kill any running ableosc-mcp server first to free port 11001
lsof -ti :11001 | xargs kill
ABLEOSC_INTEGRATION=1 uv run pytest tests/integration/ -v

# Coverage report
uv run pytest tests/unit/ --cov --cov-report=term-missing

建筑

AI client (Claude Desktop, Cursor, etc.)
    │  MCP / stdio
    ▼
src/ableosc/server.py        ← FastMCP server, tool registration
    │  asyncio + python-osc / UDP
    ▼
AbletonOSC Remote Script     ← installed in Ableton Live
(inside Ableton Live)
    │  Live Python API
    ▼
Ableton Live

与实现自定义协议的其他Ableton MCP集成不同，该项目包含 AbletonOSC -一个成熟、测试良好的远程脚本，具有全面的API表面，包括实时事件侦听器。

许可证

麻省理工学院——见 许可证.