Ableton Live MCP Server

Ableton Live MCP 服务

📌 概述

Ableton Live MCP 服务是一个实现 模型上下文协议（MCP） 的服务，用于促进 大模型与 Ableton Live 之间的通信。它使用 OSC（开放声音控制） 与 Ableton Live 收发消息。该项目基于 AbletonOSC 实现，并将可用的 OSC 地址全面映射为 MCP 客户端可访问的工具。

该项目由两个主要组件构成：

• mcp_ableton_server.py：处理客户端与 OSC 守护进程之间通信的 MCP 服务。
• osc_daemon.py：负责向 Ableton Live 转发命令并处理响应的 OSC 守护进程。

✨ 功能

• 提供兼容 MCP 的 API，供 MCP 客户端控制 Ableton Live。
• 使用 python-osc 收发 OSC 消息。
• 基于 AbletonOSC 中的 OSC 实现。
• 为 Ableton Live 命令实现请求-响应处理。

⚡ 安装

要求

• Python 3.8+
• python-osc（用于 OSC 通信）
• fastmcp（用于支持 MCP）
• uv（推荐的 Python 包安装程序）
• AbletonOSC，用作控制表面

安装步骤

1. 安装 uv（https://docs.astral.sh/uv/getting-started/installation）：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. 克隆仓库：

   git clone https://github.com/your-username/mcp_ableton_server.git
   cd mcp_ableton_server
   

3. 安装项目及其依赖项：

   uv sync
   

4. 安装 AbletonOSC。请按照 AbletonOSC 中的说明操作。

🚀 使用方法

运行 OSC 守护进程

OSC 守护进程将处理 MCP 服务与 Ableton Live 之间的 OSC 通信：

uv run osc_daemon.py

它将：

• 在端口 65432 上监听 MCP 客户端连接。
• 通过端口 11000 上的 OSC 将消息转发至 Ableton Live。
• 在端口 11001 上接收来自 Ableton 的 OSC 响应。

使用示例

在 Claude 桌面版中向 Claude 提出要求：

• 准备一套用于录制摇滚乐队的设置
• 将名称中包含“voice”的所有音轨的输入路由通道设为 Ext. In 2

⚙️ 配置

默认情况下，服务和守护进程运行在 localhost（127.0.0.1） 上，使用以下端口：

• MCP 服务套接字： 65432
• Ableton Live OSC 端口（发送）： 11000
• Ableton Live OSC 端口（接收）： 11001

如需修改这些设置，请编辑 osc_daemon.py 中的 AbletonOSCDaemon 类：

self.socket_host = '127.0.0.1'
self.socket_port = 65432
self.ableton_host = '127.0.0.1'
self.ableton_port = 11000
self.receive_port = 11001

Claude Desktop 配置

要将此服务与 Claude Desktop 搭配使用，需要在 Claude Desktop 设置中进行配置。配置文件的位置因操作系统而异：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

将以下配置添加到 mcpServers 部分：

{
  "mcpServers": {
    "Ableton Live Controller": {
      "command": "/path/to/your/project/.venv/bin/python",
      "args": ["/path/to/your/project/mcp_ableton_server.py"]
    }
  }

此配置可确保：

• 服务运行时妥善管理所有依赖项
• 项目保持可移植且可复现

贡献

欢迎提交问题、功能请求或拉取请求，帮助改进此项目。

许可证

此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

致谢

• 模型上下文协议（MCP）
• python-osc，用于处理 OSC
• Daniel John Jones，感谢其通过 AbletonOSC 实现 OSC
• Ableton 第三方远程脚本
• Julien Bayle @Structure Void，感谢其源源不断的灵感与资源。

待办事项

• 探索 资源 和 提示词 原语的应用机会。
• 构建独立的 Ableton Live MCP 客户端。

---