📌 개요

Ableton Live MCP 서버는 다음 기능을 구현하는 서버입니다. 모델 컨텍스트 프로토콜(MCP) LLM과 Ableton Live 간의 통신. 이 게임은 OSC(오픈 사운드)를 사용합니다. Control) 는 Ableton Live와 메시지를 주고받는 데 사용됩니다. 이 방법은 AbletonOSC 구현 및 이용 가능한 OSC 주소를 포괄적으로 매핑합니다. 도구 접근 가능 MCP 클라이언트.

이 프로젝트는 두 가지 주요 구성 요소로 구성되어 있습니다:

• mcp_ableton_server.py: 통신을 처리하는 MCP 서버 클라이언트와 OSC 데몬.
• osc_daemon.py: Ableton에 명령을 전달하는 OSC 데몬 실시간 및 처리 중인 응답.

✨ 특징

• MCP 클라이언트에서 Ableton Live를 제어할 수 있는 MCP 호환 API를 제공합니다.
• OSC 메시지 송수신에 python-osc를 사용합니다.
• OSC 구현 기반 AbletonOSC.
• Ableton Live 명령어에 대한 요청-응답 처리를 구현합니다.

⚡ 설치

요구 사항

• 파이썬 3.8+
• python-osc (OSC 통신용)
• fastmcp (MCP 지원용)
• uv (추천 파이썬 패키지 설치 프로그램)
• 컨트롤 서피스로서의 AbletonOSC

설치 단계

1. uv (https://docs.astral. 설치

Ableton Live MCP Server

📌 Overview

The Ableton Live MCP Server is a server implementing the Model Context Protocol (MCP) to facilitate communication between LLMs and Ableton Live. It uses OSC (Open Sound Control) to send and receive messages to/from Ableton Live. It is based on AbletonOSC implementation and exhaustively maps available OSC adresses to tools accessible to MCP clients.

This project consists of two main components:

• mcp_ableton_server.py: The MCP server handling the communication between clients and the OSC daemon.
• osc_daemon.py: The OSC daemon responsible for relaying commands to Ableton Live and processing responses.

✨ Features

• Provides an MCP-compatible API for controlling Ableton Live from MCP clients.
• Uses python-osc for sending and receiving OSC messages.
• Based on the OSC implementation from AbletonOSC.
• Implements request-response handling for Ableton Live commands.

⚡ Installation

Requirements

• Python 3.8+
• python-osc (for OSC communication)
• fastmcp (for MCP support)
• uv (recommended Python package installer)
• AbletonOSC as a control surface

Installation Steps

1. Install uv (https://docs.astral.sh/uv/getting-started/installation):

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

2. Clone the repository:

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

3. Install the project and its dependencies:

   uv sync
   

4. Install AbletonOSC Follow the instructions at AbletonOSC

🚀 Usage

Running the OSC Daemon

The OSC daemon will handle OSC communication between the MCP server and Ableton Live:

uv run osc_daemon.py

This will:

• Listen for MCP client connections on port 65432.
• Forward messages to Ableton Live via OSC on port 11000.
• Receive OSC responses from Ableton on port 11001.

Example Usage

In Claude desktop, ask Claude:

• Prepare a set to record a rock band
• Set the input routing channel of all tracks that have “voice” in their name to Ext. In 2

⚙️ Configuration

By default, the server and daemon run on localhost (127.0.0.1) with the following ports:

• MCP Server Socket: 65432
• Ableton Live OSC Port (Send): 11000
• Ableton Live OSC Port (Receive): 11001

To modify these, edit the AbletonOSCDaemon class in osc_daemon.py:

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