переведено ИИ

AbletonMCP - Интеграция Ableton Live с Протоколом Контекста Моделей

AbletonMCP соединяет Ableton Live с Claude AI через Протокол Контекста Моделей (MCP), позволяя Claude напрямую взаимодействовать с Ableton Live и управлять им. Эта интеграция обеспечивает создание музыки с помощью подсказок, создание треков от начала до конца, а также управление сессиями и аранжировкой в Live.

Присоединяйтесь к Сообществу

Давайте обратную связь, черпайте вдохновение и создавайте на основе MCP: Discord. Создано Siddharth

Возможности

Двусторонняя связь: Соединение Claude AI с Ableton Live через сервер на основе сокетов
Управление дорожками: Создание, модификация и управление MIDI- и аудиодорожками
Выбор инструментов и эффектов: Claude может получать доступ к библиотеке Ableton и загружать нужные инструменты, эффекты и звуки
Создание клипов: Создание и редактирование MIDI-клипов с нотами
Композиция в режиме Аранжировки: Автономное создание полноценных песен в режиме Аранжировки, включая такие секции, как интро, нарастание, дроп, брейкдаун и аутро
Управление сессией: Запуск и остановка воспроизведения, запуск клипов и управление транспортом в режимах Сессия и Аранжировка
Анонимная телеметрия: Отслеживание использования для улучшения инструмента (можно отключить)

Компоненты

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

Удаленный скрипт Ableton (Ableton_Remote_Script/__init__.py): Скрипт удаленного управления MIDI для Ableton Live, который создает сервер сокетов для приема и выполнения команд.
Сервер MCP (server.py): Python-сервер, реализующий Протокол Контекста Моделей и подключающийся к удаленному скрипту Ableton.

Установка

Установка через Smithery

Для автоматической установки интеграции Ableton Live для Claude Desktop через Smithery:

npx -y @smithery/cli install @ahujasid/ableton-mcp --client claude

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

Ableton Live 10 или новее
Python 3.8 или новее
пакетный менеджер uv

Если вы используете Mac, пожалуйста, установите uv так:

brew install uv

В остальных случаях установите с официального сайта uv

⚠️ Не продолжайте установку, пока не установите UV

Интеграция с Claude Desktop

Следуйте инструкциям из видео

Перейдите в Claude > Настройки > Разработчик > Редактировать конфигурацию > claude_desktop_config.json и добавьте следующее:

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

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

Запускайте ableton-mcp без постоянной установки через uvx. Перейдите в Настройки Cursor > MCP и вставьте эту команду:

uvx ableton-mcp

⚠️ Запускайте только один экземпляр сервера MCP (либо в Cursor, либо в Claude Desktop), а не оба одновременно

Установка удаленного скрипта Ableton

Следуйте инструкциям из видео

Скачайте файл AbletonMCP_Remote_Script/__init__.py из этого репозитория.
Скопируйте папку в каталог удаленных скриптов Ableton (MIDI Remote Scripts). Путь к каталогу различается для разных ОС и версий. Один из предложенных вариантов должен подойти, возможно, придется поискать:

Для macOS: - Способ 1: Перейдите в Программы > ПКМ по приложению Ableton Live → Показать содержимое пакета → Нavigate to: Contents/App-Resources/MIDI Remote Scripts/ - Способ 2: Если первый способ не сработал, используйте прямой путь (замените XX на номер вашей версии): /Users/[Имя_пользователя]/Library/Preferences/Ableton/Live XX/User Remote Scripts

Для Windows: - Способ 1: C:\Users[Имя_пользователя]\AppData\Roaming\Ableton\Live x.x.x\Preferences\User Remote Scripts - Способ 2: C:\ProgramData\Ableton\Live XX\Resources\MIDI Remote Scripts\ - Способ 3: C:\Program Files\Ableton\Live XX\Resources\MIDI Remote Scripts\ Примечание: Замените XX на номер версии вашего Ableton (например, 10, 11, 12)

Создайте папку с именем 'AbletonMCP' в каталоге удаленных скриптов и вставьте скачанный файл \_\_init\_\_.py.
Запустите Ableton Live.
Перейдите в Настройки/Параметры → Связь, Темп и MIDI.
В выпадающем списке Control Surface выберите "AbletonMCP".
Установите Input и Output в "None".

Использование

Запуск соединения

Убедитесь, что удаленный скрипт Ableton загружен в Ableton Live.
Убедитесь, что сервер MCP настроен в Claude Desktop или Cursor.
Соединение должно быть установлено автоматически при взаимодействии с Claude.

Использование с Claude

После настройки конфигурационного файла в Claude и запуска удаленного скрипта в Ableton вы увидите значок молотка с инструментами для Ableton MCP.

Функциональные возможности

Получение информации о сессии и дорожках
Создание и модификация MIDI- и аудиодорожек
Создание полноценных аранжировок песен от начала до конца в режиме Аранжировки
Создание, редактирование и запуск клипов
Управление воспроизведением
Загрузка инструментов и эффектов из браузера Ableton
Добавление нот в MIDI-клипы
Изменение темпа и других параметров сессии

Примеры команд

Вот несколько примеров того, что вы можете попросить Claude сделать:

"Создай трек в стиле 80-х синтвейв" Демо
"Создай хип-бит в стиле Metro Boomin"
"Создай полную аранжировку с интро, нарастанием, дропом, брейкдауном и аутро"
"Создай новую MIDI-дорожку с инструментом синтетического баса"
"Добавь реверберацию к моим ударным"
"Создай MIDI-клип на 4 такта с простой мелодией"
"Получи информацию о текущей сессии Ableton"
"Загрузи драмм-рейк 808 в выбранную дорожку"
"Добавь джазовую аккордовую прогрессию в клип на первой дорожке"
"Установи темп 120 BPM"
"Воспроизведи клип на второй дорожке"

Устранение неполадок

Проблемы с подключением: Убедитесь, что удаленный скрипт Ableton загружен и сервер MCP настроен в Claude.
Ошибки тайм-аута: Попробуйте упростить запросы или разбить их на более мелкие шаги.
Вы пробовали выключить и снова включить?: Если ошибка подключения сохраняется, попробуйте перезапустить Claude и Ableton Live.

Технические детали

Протокол взаимодействия

Система использует простой JSON-протокол поверх TCP-сокетов:

Команды отправляются как JSON-объекты с типом type и необязательными params (параметрами).
Ответы представляют собой JSON-объекты со статусом status и результатом result или сообщением message.

Ограничения и соображения безопасности

Создание сложных музыкальных аранжировок может потребовать разбиения на более мелкие шаги.
Инструмент разработан для работы со стандартными устройствами и элементами браузера Ableton.
Всегда сохраняйте свою работу перед масштабными экспериментами.

Участие в разработке

Мы приветствуем вклад! Не стесняйтесь отправлять Pull Request.

Телеметрия

AbletonMCP собирает анонимные данные об использовании для улучшения инструмента. Это включает: - Статистику использования инструмента (какие функции используются) - Информацию о сессии (для подсчета активных пользователей в день/месяц) - Показатели ошибок и производительности

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

Отключение телеметрии

Чтобы отключить телеметрию, установите одну из следующих переменных окружения перед запуском сервера MCP:

export ABLETON_MCP_DISABLE_TELEMETRY=true

Или используйте любую из этих альтернатив: - DISABLE_TELEMETRY=true - MCP_DISABLE_TELEMETRY=true

Для Claude Desktop добавьте переменную окружения в конфигурацию:

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": ["ableton-mcp"],
            "env": {
                "ABLETON_MCP_DISABLE_TELEMETRY": "true"
            }
        }
    }
}

Дисклеймер

Это сторонняя интеграция, и она создана не компанией Ableton.

Ableton MCP