Ableton MCP Extended

Управляйте Ableton Live с помощью естественного языка через ИИ-ассистентов, таких как Claude или Cursor. Этот проект предоставляет надежный сервер протокола контекста модели (MCP), который переводит команды на естественном языке в точные действия внутри вашей сессии Ableton Live.

Видеодемонстрация: https://www.youtube.com/watch?v=7ZKPIrJuuKk

Этот инструмент предназначен для продюсеров, разработчиков и энтузиастов ИИ, которые хотят оптимизировать свой рабочий процесс создания музыки, экспериментировать с генеративной музыкой и создавать пользовательские интеграции с Ableton Live.

Вы можете превратить этот диалог:

👤 "Create a brief minimalist/neo-classical composition in a style similar to Ólafur Arnalds'. (Ableton MCP) / I've loaded four MIDI tracks called "Noire" and "Noire (2) ["Emotional Felt" presets], "Noire (2) ["Reversed Felt" preset, for ambient background], and "Noire (3) ["Ethereal Felt" preset, also for ambient background]. All loaded with nice piano instruments. You have also a MIDI track called "Strings" with a nice string ensemble instrument loaded. Feel free to add new instruments and effects, if pertinent."
🤖 "Creating MIDI clips... Adding effects... Done!"
👤 "Then, use ElevenLabs MCP to create a spoken-word audio clip (default voice and settings) with a relevant poem in the style of “Jim Morrison” to accompany the composition."  
🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"

В эту сессию создания музыки:

https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3

Основные возможности

Этот проект предоставляет комплексное программное управление средой Ableton Live.

• Управление сессией и транспортом:

  • Запуск и остановка воспроизведения.

  • Получение информации о сессии, включая темп, размер и количество дорожек.

  • Управление сценами: создание, удаление, переименование и запуск.

• Управление дорожками:

  • Создание, переименование и получение подробной информации о MIDI- и аудиодорожках.

  • Управление свойствами дорожек: громкость, панорамирование, отключение звука (mute), соло и запись (arm).

  • Управление группировкой и сворачиванием дорожек.

• Манипуляции с MIDI-клипами и нотами:

  • Создание и именование MIDI-клипов заданной длины.

  • Добавление, удаление, транспонирование и квантование нот внутри клипов.

  • Пакетное редактирование нескольких нот за одну операцию.

  • Настройка параметров зацикливания клипа и действий после завершения (follow actions).

• Управление устройствами и параметрами:

  • Загрузка инструментов и эффектов из браузера Ableton по URI.

  • Получение полного списка параметров для любого устройства на дорожке.

  • Установка и пакетная установка параметров устройств с использованием нормализованных значений (от 0.0 до 1.0).

• Автоматизация и огибающие:

  • Добавление и очистка точек автоматизации для любого параметра устройства внутри клипа. [Эта функция пока работает не идеально.]

  • Получение информации о существующих огибающих клипа.

• Интеграция с браузером:

  • Навигация и просмотр элементов в браузере Ableton.

  • Загрузка инструментов, эффектов и сэмплов непосредственно по пути в браузере или URI.

  • Импорт аудиофайлов непосредственно на аудиодорожки или в слоты клипов.

• Генерация голоса и аудио

  • Интеграция Text-to-Speech: генерация дикторского текста, вокальных сэмплов или речевых элементов через ElevenLabs MCP [включено].

  • Создание пользовательских голосов: клонирование голосов для придания уникального характера вашим трекам.

  • Звуковые эффекты: создание пользовательских SFX с помощью ИИ.

  • Прямой импорт: сгенерированное аудио мгновенно появляется в вашей сессии Ableton.

• Расширяемая платформа для пользовательских инструментов

  • Пример: XY Mouse Controller: демонстрирует создание пользовательских контроллеров Ableton с помощью платформы MCP.

  • Сверхнизкая задержка: высокопроизводительный протокол UDP обеспечивает отзывчивое управление в реальном времени.

  • Безграничные возможности: создавайте свои собственные инструменты и контроллеры для Ableton Live.

Быстрый старт (5 минут)

Предварительные требования

• Ableton Live 11+ (любая версия)

• Python 3.10 или выше

• Claude Desktop или Cursor IDE

1. Получите код

git clone https://github.com/uisato/ableton-mcp-extended.git
cd ableton-mcp-extended
pip install -e .

2. Установите скрипт Ableton

1. Найдите папку Remote Scripts в Ableton:

   • Windows: C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\

   • Mac: ~/Library/Preferences/Ableton/Live [Version]/User Remote Scripts/

2. Создайте папку: AbletonMCP

3. Скопируйте AbletonMCP_Remote_Script/__init__.py в эту папку

3. Настройте Ableton

1. Откройте Ableton Live

2. Перейдите в Preferences → Link, Tempo & MIDI

3. Установите Control Surface на "AbletonMCP"

4. Установите Input/Output на "None"

4. Подключите ИИ-ассистента

Для Claude Desktop:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
    }
  }
}

Для Cursor: Добавьте MCP-сервер в Settings → MCP с тем же путем.

5. Начните творить!

Откройте своего ИИ-ассистента и попробуйте:

• "Create a new MIDI track with a piano"

• "Add a simple drum beat"

• "What tracks do I currently have?"

Как это работает

graph TB
    A[You: Natural Language] --> B[AI Assistant]
    B --> C[MCP Server]
    C --> D[Ableton Remote Script]
    D --> E[Ableton Live API]
    E --> F[🎵 Your Music]
    
    G[ElevenLabs AI] --> H[Generated Audio]
    H --> C

1. Вы отдаете команду на обычном английском языке своему ИИ-ассистенту (например, "Create a new MIDI track and name it 'Bass'").

2. ИИ-ассистент понимает намерение и вызывает соответствующий инструмент с MCP-сервера.

3. MCP-сервер (server.py) получает вызов инструмента и формирует конкретную JSON-команду.

4. Удаленный скрипт Ableton (init.py), работающий внутри Live, получает JSON-команду через сокет-соединение.

5. Удаленный скрипт выполняет команду, используя официальный API Ableton Live, мгновенно внося изменения в вашу сессию.

Дополнительные возможности

Для управления параметрами в реальном времени со сверхнизкой задержкой:

# Install the hybrid server
cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/

# Try the XY Mouse Controller example
cd experimental_tools/xy_mouse_controller
python mouse_parameter_controller_udp.py

Это демонстрирует, как создавать:

• Пользовательские контроллеры реального времени для Ableton

• Инструменты для выразительного исполнения

• Интерактивные музыкальные приложения

Этот репозиторий можно интегрировать с другими MCP-серверами, например, с сервером для ElevenLabs, чтобы генерировать и импортировать аудио непосредственно в ваш проект.

Настройте MCP-сервер ElevenLabs в соответствии с его инструкциями.

Обновите конфигурацию вашего ИИ-ассистента, чтобы включить оба сервера.

Пример mcp-config.json:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["/path/to/ableton-mcp-extended/server.py"]
    },
    "ElevenLabs": {
      "command": "python",
      "args": ["/path/to/elevenlabs_mcp/server.py"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Обзор компонентов

Этот проект включает несколько специализированных компонентов:

Основной MCP-сервер

• Стандартная TCP-связь для надежного управления через ИИ

• Обширная интеграция с API Ableton Live

• Совместимость с Claude Desktop, Cursor и Gemini CLI.

Гибридный TCP/UDP-сервер

• Высокопроизводительное управление параметрами в реальном времени

• Сверхнизкая задержка для живых выступлений

• Идеально подходит для контроллеров и интерактивных инструментов

Интеграция с ElevenLabs

• Профессиональная генерация речи (text-to-speech)

• Создание и клонирование пользовательских голосов

• Прямой импорт в сессии Ableton

• Генерация SFX в реальном времени

Экспериментальные инструменты и примеры

• XY Mouse Controller: пример, демонстрирующий создание пользовательских контроллеров Ableton

• Расширяемая платформа: основа для создания собственных интерфейсов управления

• Proof of Concept: показывает мощь и гибкость подхода MCP

Документация

• Руководство по установке - Подробные инструкции по настройке

• Руководство пользователя - Что, где и как

Сообщество и поддержка

• GitHub Issues: отчеты об ошибках и запросы функций

• Discussions: делитесь своими творениями и получайте помощь

Поделитесь своими творениями

Отмечайте меня в своих экспериментах, созданных с помощью ИИ! Мне нравится видеть, что создает сообщество:

YouTube | Instagram | Patreon | Website

Что дальше

• Исправление ошибок размещения точек автоматизации

• ~~Поддержка VST-плагинов - Управление сторонними плагинами [Хотя этого можно добиться через функцию настройки параметров "Configure"]~~ → Готово!

• Режим Arrangement View - Полное управление временной шкалой

• Аппаратная интеграция - Подключение MIDI-контроллеров через ИИ

• Продвинутый ИИ - Более умное и качественное понимание и генерация музыки

Лицензия и авторы

Этот проект лицензирован по лицензии MIT - подробности см. в LICENSE.

Создано с использованием:

• Model Context Protocol - платформа интеграции ИИ

• ElevenLabs API - профессиональная генерация голоса

• Ableton Live - цифровая звуковая рабочая станция

Вдохновлено: оригинальным проектом ableton-mcp

Сделано с ❤️ для сообщества музыкальных продюсеров

Если этот проект помогает вашему творчеству, подумайте о том, чтобы поставить ему ⭐ звезду!