blaspalmisciano-ps/ableton-mcp-skill

Was macht ableton-mcp-skill?

AbletonMCP Skill – Steuere Ableton Live über einen TCP-Socket direkt aus Claude Code heraus. Mit gepatchtem Remote-Skript und Indie-Rock-Preset.

Übersicht

Dieses Skill verbindet Claude Code mit Ableton Live über das Model Context Protocol. Es verwendet einen benutzerdefinierten TCP-Socket, um MIDI- und Steuerbefehle zu senden. Das mitgelieferte Remote-Skript patcht die Standard-Ableton-API, um zusätzliche Funktionen freizuschalten, während das Indie-Rock-Preset eine fertige Projektvorlage bietet.

Voraussetzungen

• Ableton Live 11 oder 12 (Suite oder Standard)
• Python 3.8+ mit pip
• Claude Code (CLI)
• Betriebssystem: macOS (empfohlen) oder Linux

Installation

1. Installiere das Python-Paket:

   pip install git+https://github.com/blaspalmisciano-ps/ableton-mcp-skill.git
   

2. Lege die SKILL.md im Claude-Code-Konfigurationsverzeichnis ab (standardmäßig ~/.claude/skills/).

3. Führe das Remote-Skript in Ableton Live aus:

   • Öffne Ableton Live.
   • Gehe zu Einstellungen → Link/Tempo/MIDI.
   • Aktiviere das Feld „Remote“ für das entsprechende MIDI-Eingabegerät.
   • Wähle das Skript AbletonMCP aus der Dropdown-Liste „Control Surface“ aus.

4. Starte den MCP-Server:

   ableton-mcp-server
   

Verwendung

Sobald das Skill konfiguriert ist, kannst du Claude Code natürlichsprachliche Befehle geben, zum Beispiel:

• „Starte Szene 3 des Indie-Rock-Presets.“
• „Setze Tempo auf 120 BPM.“
• „Mute die Kick-Spur.“
• „Ändere den Clip-Loop auf 8 Takte.“

Preset-Details

Das mitgelieferte Indie-Rock-Preset enthält:

• 1 Bass-Spur – einfacher, treibender Basslauf
• 2 Gitarren-Spuren – clean und verzerrt
• 1 Schlagzeug-Spur – Kick, Snare, Hi-Hat, Becken
• 1 Keyboard-Spur – Pad und Arpeggio (optional)
• Master-Effekte – leichter Kompressor, Hall, Delay

Beispiel-Session

# Beispiel für Python-Steuerung via MCP
from ableton_mcp import AbletonMCPClient

client = AbletonMCPClient()
client.start_session()
client.load_preset("indie_rock")
client.play_scene(2)

Fehlerbehebung

• Socket-Fehler: Stelle sicher, dass der Ableton-MCP-Server läuft und der Port (standardmäßig 9876) nicht blockiert ist.
• Keine Antwort: Überprüfe, ob die Control Surface im Ableton-MIDI-Setup korrekt ausgewählt ist.
• Clips springen nicht: Setze den Transport in Ableton auf „Stop“ und wähle eine Szene manuell aus, bevor du einen Befehl sendest.

Lizenz

MIT – siehe LICENSE für Details.