ableton-copilot-mcp

Сервер MCP (Model Context Protocol), созданный на основе ableton-js для взаимодействия и управления в реальном времени с Ableton Live, призванный помогать музыкальным продюсерам в создании музыки.

🎯 Примечание

Как музыкальный продюсер, я имею некоторое представление об использовании Ableton для создания музыки. В процессе творчества нам часто приходится выполнять различные утомительные операции, такие как очеловечивание свойств нот, объединение нот, запись одной дорожки на другую звуковую дорожку и т. д. Раньше для этих операций мы могли полагаться только на функции, предоставляемые хостовой DAW. Однако с появлением больших языковых моделей и MCP у нас теперь есть возможность позволить ИИ помочь нам с автоматизацией. Хотя для ИИ все еще нереально напрямую генерировать ноты или создавать целую песню (он не может генерировать хорошо звучащую песню), помощь ИИ с вспомогательными операциями представляет собой новую возможность.

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

🎵 Управление песней

• Получите основную информацию о песне (основной тон, название тональности, темп, длительность песни и т. д.)

• Получить список всех треков

• Создавайте MIDI, аудио и обратные треки

• Удалить и дублировать треки

🎹 Управление трассой

• Получить все клипы в треке

• Создание пустых MIDI-клипов в дорожках аранжировки

• Создавайте аудиоклипы в дорожках на основе предоставленных путей к файлам-образцам

• Установить свойства дорожки (отключение звука, цвет, название, включение, соло и т. д.)

• Дублировать MIDI-клипы на указанные дорожки

🎼 Операции с клипами

• Получить клипы в режиме просмотра пианино

• Получайте и управляйте всеми заметками в клипе

• Добавлять, удалять и заменять заметки в клипах

• Задайте свойства клипа (имя, цвет, цикл, loop_start, loop_end и т. д.)

🎧 Аудио операции

• Поддерживает запись содержимого трека на основе временного диапазона.

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

• Загрузить аудиоэффекты, инструменты и плагины

• Изменить параметры устройства

• Просмотрите доступные устройства в библиотеке

📝 Государственное управление

• Отслеживание истории операций и подробное протоколирование

• Создание моментальных снимков для критических операций

• Поддержка отката операций (особенно для операций с заметками)

• Просмотр и восстановление предыдущих состояний

📝 Список дел

• Разрешить возвращать созданный clip_id при создании MIDI-клипов (ожидается обновление ableton-js)

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

• Поддержка большего количества типов снимков (свойства трека, параметры устройства и т. д.)

⚠️ Предупреждение

• Прямая манипуляция клипами MIDI с помощью ИИ может привести к потере исходных нот и не может быть отменена с помощью Ctrl + Z. Пожалуйста, действуйте осторожно. При необходимости вы можете попросить ИИ помочь вам откатить операции с нотами.

📥 Установка

Предпосылки

• Среда Node.js : убедитесь, что установлен Node.js (рекомендуется версия 20+) и доступна команда npx

  🔗 Скачать: официальный сайт Node.js

Этапы установки

1. Установите удаленные скрипты AbletonJS MIDI

Выберите ОДИН из следующих трех методов установки сценариев MIDI Remote:

• Метод 1: однолинейная установка (рекомендуется)

  npx @xiaolaa2/ableton-copilot-mcp --install-scripts # or use the short form npx @xiaolaa2/ableton-copilot-mcp -is

• Метод 2: Установка с помощью инструментов

  1. Сначала запустите ableton-copilot-mcp (см. раздел «Использование» ниже)

  2. Позвольте помощнику ИИ или вручную вызвать инструмент MCP init_ableton_js для автоматического завершения установки

• Метод 3: Ручная установка

  1. Создайте папку с именем «Remote Scripts» в вашей пользовательской библиотеке Ableton:

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

     • Mac: /Users/[username]/Music/Ableton/User Library\Remote Scripts

  2. Загрузите скрипты MIDI Remote из проекта ableton-js

  3. Скопируйте загруженную папку midi-script в указанное выше место

  4. Переименуйте его в AbletonJS

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

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

1. Запустить Ableton Live

2. Включить панель управления AbletonJS

   • Откройте настройки Ableton Live: Preferences → Link/MIDI

   • На вкладке MIDI найдите раздел Control Surface .

   • Выберите AbletonJS из выпадающего меню.

3. Подключитесь с помощью клиента MCP

   В качестве конечных точек MCP могут использоваться следующие клиенты:

   • Курсор

   • Студия Черри

   • Клод Десктоп

   • Другие клиенты MCP

Конфигурация клиента

Пример конфигурации курсора

Добавьте следующую конфигурацию в настройки курсора:

Для последней версии:

Пользовательский путь хранения (необязательно)

Вы можете указать пользовательское место хранения данных с помощью переменной среды BASE_PATH :

💡 Совет : путь к хранилищу используется для сохранения файлов журнала, истории операций и снимков состояния.

Советы по использованию

• При первом подключении может потребоваться несколько секунд для установления связи с Ableton Live.

• Убедитесь, что Ableton Live запущен и AbletonJS Control Surface правильно загружен.

• Для проверки состояния соединения можно использовать команду get_song_status в инструментах MCP.

✅ Тестирование совместимости

Совместимость в первую очередь зависит от поддержки версии библиотеки ableton-js .

🤝 Вклад

Вопросы и вклады приветствуются. Пожалуйста, отправляйте вопросы или предложения через GitHub Issues .

📄 Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .

⚠️ Отказ от ответственности

Это сторонняя интеграция, а не Ableton.