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: Установка с помощью инструментов
- Сначала запустите ableton-copilot-mcp (см. раздел «Использование» ниже)
- Позвольте помощнику ИИ или вручную вызвать инструмент MCP
init_ableton_js для автоматического завершения установки
- Метод 3: Ручная установка
- Создайте папку с именем «Remote Scripts» в вашей пользовательской библиотеке Ableton:
- Windows:
C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts - Mac:
/Users/[username]/Music/Ableton/User Library\Remote Scripts
- Загрузите скрипты MIDI Remote из проекта ableton-js
- Скопируйте загруженную папку
midi-script в указанное выше место - Переименуйте его в
AbletonJS
🔧 Использование
Быстрый старт
- Запустить Ableton Live
- Включить панель управления AbletonJS
- Откройте настройки Ableton Live:
Preferences → Link/MIDI - На вкладке
MIDI найдите раздел Control Surface . - Выберите
AbletonJS из выпадающего меню.
- Подключитесь с помощью клиента MCPВ качестве конечных точек MCP могут использоваться следующие клиенты:
Конфигурация клиента
Пример конфигурации курсора
Добавьте следующую конфигурацию в настройки курсора:
"ableton-js-mcp": {
"command": "npx",
"args": [
"-y",
"@xiaolaa2/ableton-copilot-mcp"
]
}
Для последней версии:
"ableton-js-mcp": {
"command": "npx",
"args": [
"-y",
"@xiaolaa2/ableton-copilot-mcp@latest"
]
}
Пользовательский путь хранения (необязательно)
Вы можете указать пользовательское место хранения данных с помощью переменной среды BASE_PATH :
"ableton-js-mcp": {
"command": "npx",
"args": [
"-y",
"@xiaolaa2/ableton-copilot-mcp"
],
"env": {
"BASE_PATH": "D:\\ableton_copilot_mcp"
}
}
💡 Совет : путь к хранилищу используется для сохранения файлов журнала, истории операций и снимков состояния.
Советы по использованию
- При первом подключении может потребоваться несколько секунд для установления связи с Ableton Live.
- Убедитесь, что Ableton Live запущен и AbletonJS Control Surface правильно загружен.
- Для проверки состояния соединения можно использовать команду
get_song_status в инструментах MCP.
✅ Тестирование совместимости
Совместимость в первую очередь зависит от поддержки версии библиотеки ableton-js .
| Ableton Live-версия | Статус теста |
|---|
| 12.1.10 | ✅ Проверено и работает |
| 11.х | ⚠️ Пока не тестировалось |
| 10.х | ⚠️ Пока не тестировалось |
🤝 Вклад
Вопросы и вклады приветствуются. Пожалуйста, отправляйте вопросы или предложения через GitHub Issues .
📄 Лицензия
Данный проект лицензирован в соответствии с лицензией MIT .
⚠️ Отказ от ответственности
Это сторонняя интеграция, а не Ableton.