📌 Обзор

Ableton Live MCP Server — это сервер, реализующий Протокол контекста модели (MCP) для облегчения Связь между LLM и Ableton Live. Используется OSC (Open Sound Control) для отправки и получения сообщений в/от Ableton Live. Он основан на Реализация AbletonOSC и исчерпывающе отображает доступные адреса OSC на инструменты доступны для Клиенты MCP.

Этот проект состоит из двух основных компонентов:

• mcp_ableton_server.py: MCP-сервер, обрабатывающий коммуникацию между клиентов и демона OSC.
• osc_daemon.py: демон-оск, отвечающий за передачу команд в Ableton Живой и обрабатывающий ответы.

✨ Особенности

• Предоставляет совместимый с MCP API для управления Ableton Live из MCP-клиентов.
• Использует python-osc для отправки и получения OSC-сообщений.
• На основе реализации OSC из AbletonOSC.
• Реализует обработку запрос-ответ для команд Ableton Live.

⚡ Установка

Требования

• Python 3.8+
• python-osc (для связи с OSC)
• fastmcp (для поддержки MCP)
• uv (рекомендуемый установщик пакетов Python)
• 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