Ableton MCP Extended

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

Форк с доработками. Добавлено 22 команды Remote Script и 25 инструментов MCP: чтение MIDI-нот, сцены, свойства session-клипов, микшер (mute/solo/arm, посылы), матрица модуляции Wavetable, undo/redo. Подробности и установка — в FORK-NOTES.md.

Видеодемонстрация: 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, solo и arm.

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

• Работа с MIDI-клипами и нотами:

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

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

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

  • Настройка параметров цикла клипа и follow-действий.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Related MCP server: io.github.peterkolbe/ableton-for-ai

Быстрый старт (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\[Вы]\Documents\Ableton\User Library\Remote Scripts\

   • Mac: ~/Music/Ableton/User Library/Remote Scripts/

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

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

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

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

2. Перейдите в Настройки → 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. Начните создавать!

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

• "Создай новый MIDI-трек с пианино"

• "Добавь простой барабанный бит"

• "Какие треки у меня сейчас есть?"

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

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. Вы отправляете команду на простом английском вашему ИИ-ассистенту (например, "Создай новый MIDI-трек и назови его 'Bass'").

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

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

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

5. Remote Script выполняет команду с помощью официального 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 | Веб-сайт

Что дальше

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

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

• Arrangement View — полное управление таймлайном

• Аппаратная интеграция — мост MIDI-контроллеров через ИИ

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

Лицензия и благодарности

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

Создано с помощью:

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

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

• Ableton Live — цифровая аудиостанция

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

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

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