Ableton Live MCP Server

Ableton Live MCP Server

site icon
2025.03.27 208
Python音乐制作自动化控制娱乐功能
Ableton Live MCP Server 是一个实现 Model Context Protocol (MCP) 的服务器,用于促进 LLMs 与 Ableton Live 之间的通信。它使用 OSC (Open Sound Control) 发送和接收消息到/从 Ableton Live。该项目基于 AbletonOSC 实现,并将可用的 OSC 地址详尽地映射到 MCP 客户端可访问的工具。
View on GitHub

Overview

基本能力

产品定位

Ableton Live MCP Server 是一个用于控制 Ableton Live 的 MCP 兼容服务器,通过 OSC 协议实现与 Ableton Live 的通信。

核心功能

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

适用场景

  • 通过 LLMs 控制 Ableton Live 进行音乐制作和录音。
  • 自动化 Ableton Live 的轨道设置和路由。
  • 与 Claude Desktop 集成,通过自然语言指令控制 Ableton Live。

工具列表

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

常见问题解答

  • 如何修改服务器和守护进程的默认端口? 编辑 osc_daemon.py 中的 AbletonOSCDaemon 类,修改相应的端口和主机设置。
  • 如何与 Claude Desktop 集成? 在 Claude Desktop 的配置文件中添加 MCP 服务器配置,指定服务器路径和参数。

使用教程

使用依赖

  • Python 3.8+
  • python-osc (用于 OSC 通信)
  • fastmcp (用于 MCP 支持)
  • uv (推荐的 Python 包安装工具)
  • AbletonOSC 作为控制面

安装教程

  1. 安装 uv: bash curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 克隆仓库: bash git clone https://github.com/your-username/mcp_ableton_server.git cd mcp_ableton_server
  3. 安装项目及其依赖: bash uv sync
  4. 安装 AbletonOSC: 按照 AbletonOSC 的说明进行安装。

调试方式

运行 OSC 守护进程:

uv run osc_daemon.py

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

许可证

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