Ableton Copilot MCP

Ableton-Copilot-MCP

Ein auf Ableton-JS basierender MCP-Server (Model Context Protocol) für die Echtzeitinteraktion und -steuerung mit Ableton Live, der Musikproduzenten bei ihrer Musikproduktion unterstützen soll.

🎯 Hinweis

Als Musikproduzent kenne ich mich mit der Verwendung von Ableton für die Musikproduktion aus. Im kreativen Prozess müssen wir oft verschiedene mühsame Aufgaben erledigen, wie z. B. das Anpassen von Noteneigenschaften, das Zusammenführen von Noten, das Aufnehmen einer Spur in eine andere Audiospur usw. Bisher konnten wir uns hierfür ausschließlich auf die Funktionen der Host-DAW verlassen. Mit dem Aufkommen großer Sprachmodelle und MCP haben wir nun jedoch die Möglichkeit, uns bei der Automatisierung von KI unterstützen zu lassen. Obwohl es für KI noch unrealistisch ist, direkt Noten zu generieren oder einen kompletten Song zu erstellen (sie kann keinen gut klingenden Song generieren), eröffnet die Unterstützung durch KI bei zusätzlichen Aufgaben neue Möglichkeiten.

🚀 Funktionen

🎵 Songsteuerung

• Erhalten Sie grundlegende Songinformationen (Grundton, Tonleitername, Tempo, Songlänge usw.)
• Holen Sie sich eine Liste aller Titel
• Erstellen Sie MIDI-, Audio- und Return-Tracks
• Löschen und Duplizieren von Titeln

🎹 Streckenverwaltung

• Alle Clips in einer Spur abrufen
• Erstellen Sie leere MIDI-Clips in den Spuren der Arrangement-Ansicht
• Erstellen Sie Audioclips in Spuren basierend auf den bereitgestellten Beispieldateipfaden
• Legen Sie die Spureigenschaften fest (Stummschaltung, Farbe, Name, Arm, Solo usw.).
• MIDI-Clips auf angegebene Spuren duplizieren

🎼 Clip-Operationen

• Holen Sie sich Clips in der Pianorollenansicht
• Alle Notizen in einem Clip abrufen und verwalten
• Notizen in Clips hinzufügen, löschen und ersetzen
• Legen Sie die Clip-Eigenschaften fest (Name, Farbe, Schleife, Schleifenstart, Schleifenende usw.).

🎧 Audio-Operationen

• Unterstützt die Aufzeichnung von Titelinhalten basierend auf dem Zeitbereich

🔌 Geräteverwaltung

• Laden Sie Audioeffekte, Instrumente und Plugins
• Geräteparameter ändern
• Durchsuchen Sie die verfügbaren Geräte in der Bibliothek

📝 Zustandsverwaltung

• Verfolgung des Betriebsverlaufs und detaillierte Protokollierung
• Snapshot-Erstellung für kritische Vorgänge
• Unterstützung für das Zurücksetzen von Operationen (insbesondere für Notizoperationen)
• Durchsuchen und Wiederherstellen vorheriger Zustände

📝 Aufgabenliste

• Erlaubt die Rückgabe der erstellten Clip-ID beim Erstellen von MIDI-Clips (bis zum Ableton-JS-Update)
• Unterstützt die automatische Hüllkurvenanpassung
• Unterstützt mehr Snapshot-Typen (Spureigenschaften, Geräteparameter usw.)

⚠️ Warnung

• Die direkte Bearbeitung von MIDI-Clips durch die KI kann zum Verlust der Originalnoten führen und lässt sich nicht mit Strg + Z rückgängig machen. Gehen Sie daher vorsichtig vor. Bei Bedarf können Sie die KI bitten, Ihnen beim Zurücksetzen von Notenoperationen zu helfen.

📥 Installation

Voraussetzungen

• Node.js -Umgebung: Stellen Sie sicher, dass Node.js installiert ist (v20+ empfohlen) und der Befehl npx verfügbar ist

  🔗 Download: Offizielle Node.js-Website

Installationsschritte

1. Installieren Sie AbletonJS MIDI Remote Scripts

Wählen Sie EINE der folgenden drei Methoden zur Installation von MIDI Remote Scripts:

• Methode 1: Einzeilige Installation (empfohlen)
  npx @xiaolaa2/ableton-copilot-mcp --install-scripts # or use the short form npx @xiaolaa2/ableton-copilot-mcp -is
• Methode 2: Werkzeuggestützte Installation
  1. Starten Sie zunächst ableton-copilot-mcp (siehe Abschnitt „Verwendung“ weiter unten).
  2. Lassen Sie den KI-Assistenten oder rufen Sie das MCP-Tool init_ableton_js manuell auf, um die Installation automatisch abzuschließen
• Methode 3: Manuelle Installation
  1. Erstellen Sie in Ihrer Ableton-Benutzerbibliothek einen Ordner mit dem Namen „Remote Scripts“:
     • Windows: C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts
     • Mac: /Users/[username]/Music/Ableton/User Library\Remote Scripts
  2. Laden Sie MIDI Remote Scripts vom ableton-js- Projekt herunter
  3. Kopieren Sie den heruntergeladenen midi-script Ordner an den oben genannten Speicherort
  4. Benennen Sie es in AbletonJS

🔧 Verwendung

Schnellstart

1. Starten Sie Ableton Live
2. AbletonJS-Bedienoberfläche aktivieren
   • Öffnen Sie die Ableton Live-Einstellungen: Preferences → Link/MIDI
   • Suchen Sie auf der Registerkarte MIDI den Abschnitt Control Surface
   • Wählen Sie AbletonJS aus dem Dropdown-Menü
3. Herstellen einer Verbindung mithilfe eines MCP-ClientsDie folgenden Clients können als MCP-Endpunkte verwendet werden:
   • Cursor
   • Cherry Studio
   • Claude Desktop
   • Andere MCP-Clients

Client-Konfiguration

Beispiel für eine Cursorkonfiguration

Fügen Sie Ihren Cursoreinstellungen die folgende Konfiguration hinzu:

Für die neueste Version:

Benutzerdefinierter Speicherpfad (optional)

Sie können mit der Umgebungsvariablen BASE_PATH einen benutzerdefinierten Datenspeicherort angeben:

💡 Tipp : Der Speicherpfad wird zum Speichern von Protokolldateien, Betriebsverlauf und Status-Snapshots verwendet

Nutzungstipps

• Beim ersten Verbinden kann es einige Sekunden dauern, bis die Kommunikation mit Ableton Live hergestellt ist
• Stellen Sie sicher, dass Ableton Live läuft und die AbletonJS-Bedienoberfläche ordnungsgemäß geladen ist.
• Um den Verbindungsstatus zu überprüfen, können Sie den Befehl get_song_status in den MCP-Tools verwenden

✅ Kompatibilitätstests

Die Kompatibilität hängt in erster Linie von der Versionsunterstützung der Ableton-JS- Bibliothek ab.

🤝 Beitragen

Wir freuen uns über Probleme und Beiträge. Bitte reichen Sie Probleme oder Vorschläge über GitHub Issues ein.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

⚠️ Haftungsausschluss

Dies ist eine Integration eines Drittanbieters und nicht von Ableton.