Ableton Copilot MCP

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.