Ableton Holland MCP

Capture audio en direct depuis Ableton Live via VB-Cable et analyse musicale automatique avec librosa.

Architecture

┌─────────────────┐     Voicemeeter     ┌──────────────┐
│  Ableton Live   │────Virtual Input──▶│  Voicemeeter │
│  (audio engine) │                    │  (mixer)     │
└─────────────────┘                    └──────┬───────┘
                                              │
                          ┌───────────────────┼───────────────────┐
                          ▼                   ▼                   ▼
                   ┌────────────┐     ┌──────────────┐     ┌──────────────┐
                   │  Enceintes │     │  CABLE Input │     │  Casque /    │
                   │  (Intel)   │     │  (VB-Cable)  │     │  Focusrite   │
                   │  monitoring│     │  (capture)   │     │  (optionnel) │
                   └────────────┘     └──────┬───────┘     └──────────────┘
                                             │
                                             ▼
                                      ┌──────────────┐
                                      │ CABLE Output │
                                      │ (sounddevice)│
                                      └──────┬───────┘
                                             │
                                   ┌─────────┴─────────┐
                                   ▼                   ▼
                            ┌────────────┐     ┌──────────────┐
                            │ MCP server │     │  Dashboard   │
                            │ (opencode) │     │  (Tkinter)   │
                            └──────┬─────┘     └──────┬───────┘
                                   │                   │
                                   ▼                   ▼
                             ┌──────────────────────────┐
                             │      librosa (analyse)   │
                             └────────────┬─────────────┘
                                          ▼
                             ┌──────────────────────┐
                             │   data/analyses/     │
                             │   (.wav + .csv)      │
                             └──────────────────────┘

Related MCP server: io.github.peterkolbe/ableton-for-ai

Prérequis

| Logiciel | Rôle | |---|---|---| | Ableton Live 11+ | Station audio | | VB-Cable | Routage audio virtuel (capture) | | Voicemeeter (Vanilla ou Banana) | Mixeur virtuel (monitoring + routage) | | Python 3.12+ | Moteur d'analyse | | opencode | CLI agent MCP |

Installation

1. VB-Cable

1. Télécharger depuis vb-audio.com/Cable

2. Lancer VBCABLE_Setup.exe en administrateur

3. Redémarrer Windows

2. Voicemeeter

1. Télécharger depuis vb-audio.com/Voicemeeter

2. Lancer VoicemeeterSetup.exe en administrateur

3. Redémarrer Windows

3. Python

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

4. Configuration Voicemeeter

1. Lancer Voicemeeter (démarrer menu ou C:\Program Files (x86)\VB\Voicemeeter\Voicemeeter.exe)

2. Dans Hardware Out (colonne de droite) :

   • A1 → choisir tes enceintes (Intel Display Audio, Focusrite...)

   • A2 → choisir CABLE Input (VB-Audio Virtual Cable)

3. Dans Virtual Input (colonne de gauche) → laisser Voicemeeter VAIO par défaut

4. Régler les niveaux (A1 = monitoring, A2 = capture)

5. Configuration Ableton Live

1. Options → Preferences → Audio

2. Driver Type: MME / DirectX

3. Audio Output Device: Voicemeeter Virtual Audio Cable (ou Voicemeeter VAIO)

4. Audio Input Device: CABLE Output (VB-Audio Virtual Cable) (optionnel)

5. Activer "In/Out" dans la vue Session

6. AbletonMCP Remote Script

Le Remote Script AbletonMCP_Remote_Script.py (à la racine du projet) permet à ableton-mcp de communiquer avec Ableton Live via socket.

Installation

1. Copie AbletonMCP_Remote_Script.py et renommer dans le dossier des Remote Scripts d'Ableton :

--> "C:\ProgramData\Ableton\Live 12 Lite\Resources\MIDI Remote Scripts\AbletonMCP_init_.py"

copy /Y "C:\Users\admin\dev\ableton-holland-mcp\AbletonMCP_Remote_Script.py" "C:\ProgramData\Ableton\Live 12 Lite\Resources\MIDI Remote Scripts\AbletonMCP_init_.py"

copy /Y "ableton-mcp-extended\AbletonMCP_Remote_Script_init.py" "C:\ProgramData\Ableton\Live 12 Lite\Resources\MIDI Remote Scripts\AbletonMCPExtended_init.py"

2. Lance Ableton Live → Options → Preferences → Link, Tempo & MIDI

3. Dans Control Surface, sélectionne "AbletonMCP"

4. Mets Input et Output sur "None"

5. Redémarre Ableton

Le script se trouve aussi dans le dépôt GitHub original : ahujasid/ableton-mcp/AbletonMCP_Remote_Script

7. Configuration opencode

{
  "mcp": {
    "ableton-full": {
      "type": "local",
      "command": [".venv/Scripts/python", "ableton_full_mcp_server.py"],
      "enabled": true
    }
  }
}

Le serveur ableton-full (unifié) remplace les deux anciens serveurs (ableton-mcp + music-analysis). Un seul process, outils atomiques comme capture_at_position.

Outils MCP disponibles (128 tools)

Tous les indices sont 0-based (track_index=0 = première piste après Master).

Session / Transport

Pistes

Clips Session

Arrangement

Mixer

Master

Browser / Instruments

Devices

Cue Points

Vue

Automation / Enveloppes

Routing

Projet / Système

Capture & Analyse Audio

Structure du projet

 ableton-holland-mcp/
├── data/
│   ├── tests/             # Fichiers audio de test (.wav, .mp3)
│   ├── analyses/          # Résultats d'analyse (.wav + .csv)
│   └── scripts/           # Scripts utilitaires
├── dashboard/
│   └── app.py             # Interface graphique (Tkinter + matplotlib)
├── ableton_full_mcp_server.py    # Serveur MCP UNIFIÉ (Ableton + analyse)
├── AbletonMCP_Remote_Script.py   # Remote Script Ableton (à copier)
├── music_analysis_plus.py        # Serveur analyse standalone (legacy)
├── ableton_mcp_server.py         # Serveur Ableton standalone (legacy)
├── opencode.jsonc                # Configuration MCP
├── requirements.txt              # Dépendances Python
├── AGENTS.md
├── SPEC.md
├── .gitignore
└── README.md

Écouter le monitoring audio

Quand Ableton envoie son audio vers VB-Cable → plus de son dans les enceintes. Solutions :

Méthode 1 : Windows "Listen to this device"

1. Panneau de configuration → Son → Enregistrement

2. Double-clic sur "CABLE Output (VB-Audio Virtual Cable)"

3. Onglet "Écouter" → cocher "Écouter ce périphérique"

4. Choisir Focusrite / enceintes dans la liste déroulante

5. Appliquer

Avantage : sans logiciel supplémentaire. Inconvénient : léger décalage (latence WDM).

Méthode 2 : Voicemeeter (recommandée)

Route l'audio d'Ableton vers plusieurs sorties simultanément.

Configuration

1. Lance Voicemeeter

2. Hardware Out (colonne de droite) :

   • A1 → enceintes (Intel Display Audio, Focusrite...)

   • A2 → CABLE Input (VB-Audio Virtual Cable)

3. Virtual Input → Ableton envoie sur Voicemeeter VAIO

4. Ajuste les volumes (A1 = ce que tu entends, A2 = niveau envoyé à la capture)

Routage final

Ableton → Voicemeeter VAIO → A1: Enceintes (monitoring)
                            → A2: CABLE Input → CABLE Output → capture

Avantage : monitoring temps réel, contrôle du mix, pas de latence supplémentaire. Remarque : la capture MCP continue d'écouter sur CABLE Output — inchangé.

Méthode 3 : Dashboard Python

Bouton Playback dans le dashboard après chaque capture :

python dashboard/app.py

Méthode 4 : Console Python / MCP

# Dans le dashboard
from dashboard.app import AudioAnalyzer
audio, sr = AudioAnalyzer.capture(device_id, duration)
AudioAnalyzer.save_audio(audio, sr, "mon_capture")

# Dans le serveur MCP
play_wav("data/analyses/mon_capture.wav")

Dashboard graphique

Interface native Windows (Tkinter + matplotlib, zéro dépendance supplémentaire).

python dashboard/app.py

Fonctionnalités

Architecture du code

dashboard/app.py contient deux classes :

• AudioAnalyzer — capture (sounddevice), analyse (librosa), sauvegarde (soundfile)

• Dashboard — interface Tkinter, appelle AudioAnalyzer dans un thread séparé

Prochaines étapes

Itération 3 — Monitoring temps réel avec Voicemeeter ✅

• Installer et configurer Voicemeeter

• Router Ableton → Voicemeeter → enceintes (monitoring) + CABLE Input (capture)

• Valider la capture MCP inchangée

• Documenter le setup final

Itération 4 — Analyse avancée

• Détection de la tonalité / key detection (librosa.feature.tonnetz)

• Analyse harmonique (accords)

• Détection de genre / voix

Itération 5 — Améliorations pipeline

• Interface web Streamlit (dashboard plus riche, graphiques interactifs Plotly)

• Streaming continu (capture + analyse en boucle, metronome visuel)

• Whisper / transcription automatique des paroles (si voix)

• Export des résultats en JSON structuré

A etudier

• Customize Ableton Live with the Live API https://www.youtube.com/watch?v=Hfq-NXEhmzs

• Ableton free packs https://www.ableton.com/en/packs/#?item_type=free

• Future Explorations. Voir pour combiener avec un VCVRack MCP comme https://community.vcvrack.com/t/mcp-server-let-claude-cursor-build-and-control-your-rack-patches-live/25607

• autre MCP ableton : https://github.com/adamjmurray/producer-pal#readme

• https://github.com/uisato/ableton-mcp-extended

Dépannage

"CABLE Output not found"

→ Vérifier que VB-Cable est installé et qu'Ableton n'est pas en mode ASIO

Capture silencieuse

→ Vérifier qu'Ableton joue bien sur la sortie "CABLE Input" → Vérifier que la piste n'est pas en mute/solo → Vérifier le volume Master

Timeout MCP

→ Le serveur utilise async def + await asyncio.sleep() pour la capture → Si timeout : réduire la durée de capture ou vérifier les logs du serveur

• https://mcpcat.io/guides/fixing-mcp-error-32001-request-timeout/

Device busy

→ Ableton est en mode ASIO. Passer en MME/DirectX dans les préférences Ableton

Voicemeeter ne s'affiche pas dans Ableton

→ Redémarrer Voicemeeter et/ou Ableton. Vérifier que le service Voicemeeter est lancé (icône dans la barre des tâches).

Pas de son dans les enceintes (Voicemeeter)

→ Vérifier que A1 est bien assigné à un périphérique physique dans Voicemeeter → Vérifier le niveau du slider A1 → Vérifier le bouton Mute sur la colonne Virtual Input

Capture silencieuse avec Voicemeeter

→ Vérifier que A2 pointe bien vers CABLE Input → Vérifier le niveau du slider A2 → Vérifier que VB-Cable est installé

Notes de version

Itération 5 (28 juin 2026) — Serveur unifié + capture atomique

• Serveur unifié ableton_full_mcp_server.py (remplace ableton-mcp + music-analysis)

• capture_at_position(position, duration) — stop → switch → play at position → capture → stop → load

• capture_and_analyze(position, duration) — capture + analyse en un appel

• Fix start_playback_at : start_playing() PUIS current_song_time = X (Live reset le temps au démarrage)

• Fix load() : np.mean(audio, axis=1) au lieu de librosa.to_mono() (inversion canaux)

• Documentation mise à jour (README, AGENTS, SPEC)

Itération 4 (24 juin 2026) — Remote Script arrangement

• Mise à jour du Remote Script Ableton (v1314 lignes) avec support Arrangement View

• Remote Script copié à la racine du projet (AbletonMCP_Remote_Script.py)

• Documentation de l'installation du Remote Script dans le README

• Commandes arrangement : switch_to_arrangement_view, duplicate_to_arrangement, set_arrangement_time, get_arrangement_clips

Itération 3 (24 juin 2026) — Monitoring temps réel

• Voicemeeter installé et configuré (A1 = enceintes, A2 = CABLE Input)

• Monitoring en temps réel sans latence supplémentaire

• Documentation du routage Voicemeeter

Itération 2 (24 juin 2026) — Stabilisation

• Capture sauvegardée dans data/analyses/ avec timestamp

• Dashboard graphique Tkinter (capture, analyse, visualisation, playback)

• Documentation complète (README, requirements.txt, .gitignore)

• Export WAV + CSV organisé dans data/

Itération 1 (20 juin 2026) — Première version

• Serveur MCP music_analysis_plus.py avec capture async

• Analyse tempo, chroma CQT, MFCC, beats

• Fix timeout MCP (async def + await asyncio.sleep())

Licence

MIT

other mcp

• https://github.com/hidingwill/AbletonBridge , https://www.youtube.com/watch?v=I2vggJXbhrs

human voice

• https://www.youtube.com/watch?v=odSc71wYU6I

• https://www.youtube.com/watch?v=6F1BG5a5vxQ

• https://www.reddit.com/r/synthesizers/comments/13y8iid/what_are_the_best_ways_to_recreate_the_human/

• https://www.fullbucket.de/music/scrooo.html