Ableton Live MCP Server

Сервер MCP для управления Ableton Live через естественный язык и AI-агентов. Использует протокол OSC (Open Sound Control) для обмена сообщениями между большой языковой моделью (LLM) и Ableton Live. Реализация основана на проекте AbletonOSC.

Возможности

• API, совместимое с MCP, для управления Ableton Live.
• Управление командами на естественном языке через MCP-клиент.
• Автоматизация задач с помощью AI-ассистента.
• Работа через OSC-сообщения с библиотекой python-osc.

Установка

Требуется Python 3.10+ и установленный Ableton Live с включённым OSC-сервером.

1. Клонируйте репозиторий:

   git clone https://github.com/your-username/ableton-live-mcp-server.git
   cd ableton-live-mcp-server
   

2. Установите зависимости:

   pip install -r requirements.txt
   

3. Убедитесь, что Ableton Live запущен и принимает OSC-сообщения на нужном порту (по умолчанию 11000).

Конфигурация

Укажите параметры подключения через переменные окружения или файл .env:

• OSC_HOST — IP-адрес (по умолчанию 127.0.0.1)
• OSC_PORT — порт для приёма OSC (по умолчанию 11000)

Быстрый старт

Запустите сервер:

python mcp_server.py

После запуска сервер будет ожидать MCP-запросов. Через MCP-клиент (например, обёртку для Claude или другого LLM) можно отправлять команды вроде:

• «Создай новый MIDI-трек»
• «Установи громкость первого трека на -6 дБ»
• «Запусти воспроизведение»

Пример интеграции

Подключение к MCP-клиенту описывается в конфигурационном файле клиента (например, claude_desktop_config.json):

{
  "mcpServers": {
    "ableton-live": {
      "command": "python",
      "args": ["path/to/mcp_server.py"]
    }
  }
}

После этого AI-ассистент сможет отправлять команды напрямую в Ableton Live.

Предупреждения

• Для работы требуется включить OSC-приём в настройках Ableton Live (Link, Tempo & MIDI → Control Surface → AbletonOSC).
• Не все OSC-адреса из AbletonOSC реализованы — доступные команды ограничены текущими MCP-инструментами.
• Убедитесь, что порт не заблокирован брандмауэром.

Ссылки

• AbletonOSC — оригинальная реализация OSC для Ableton Live
• MCP (Model Context Protocol) specification
• python-osc