Reaper MCP Server

Dies ist ein MCP-Server, der Reaper-Projekte mit einem MCP-Client wie Claude Desktop verbindet. Damit kannst du Fragen zu deinen Projekten stellen und erhältst eine umfassende Audio-Analyse als Mixing-Feedback.

Dieser Server ist von Grund auf schreibgeschützt. Er stellt keine Werkzeuge bereit, mit denen eine KI dein Projekt verändern könnte. Er ist dazu da, zu verstehen, was du bereits erstellt hast, und zu lernen, wie du es verbessern kannst. Lass dir von der KI Ideen vorschlagen – du kannst dann selbst an den Reglern drehen und durch Ausprobieren verstehen, wie sich das auf deine Musik auswirkt.

Tools

Projekterkennung & Parsing

• find_reaper_projects: Findet alle Reaper-Projekte in dem Verzeichnis, das du in der Konfiguration angegeben hast.

• parse_reaper_project: Parst eine Reaper-Projektdatei (.RPP) und liefert detaillierte Informationen, darunter Tempo, Tracks, FX-Ketten und Audio-Items.

  Jeder Track enthält seine Position und Identität (track_number entsprechend Reapers Anzeigereihenfolge, guid), sein Routing (is_folder/folder_depth, main_send, receives, num_channels, midi_hardware_out) sowie seinen Mixer-Status (volume, pan, mute, solo). Jedes Item enthält position, length, start_offset, playrate, mute, Fades und jeden Take – wobei der aktive Take markiert ist, da dieser abgespielt wird.

  receives-Einträge benennen den Quell-Track per Index und per Namen – genau das unterscheidet einen aktiven Signalweg von einem übrig gebliebenen Track: Ein Track mit main_send: false erreicht den Master nicht, und sein Audio ist nur über das zu hören, was von ihm empfängt.

Diese Werkzeuge arbeiten Hand in Hand. Wenn du Claude eine Frage zu einem bestimmten Reaper-Projekt stellst, verwendet es das Werkzeug find_reaper_projects, um das Projekt zu finden, und anschließend das Werkzeug parse_reaper_project, um das Projekt zu parsen und deine Frage zu beantworten.

Ermittlung installierter FX

• list_installed_fx(plugin_type=None, search_query=None): Listet alle installierten FX/Plugins auf, die in Reaper verfügbar sind.

  Parameter:

  • plugin_type (optional): Nach Plugin-Typ filtern (VST2, VST3, AU, JS, CLAP)

  • search_query (optional): Plugins nach Name, Hersteller oder Typ durchsuchen

  Rückgabe: Liste der installierten Plugins, einschließlich:

  • Plugin-Name

  • Plugin-Typ (VST2, VST3, AU, JS, CLAP)

  • Dateipfad

  • Hersteller (sofern verfügbar)

  Beispielfragen:

  • „Welche Synth-Plugins habe ich installiert?“

  • „Zeig mir alle meine Waves-Plugins“

  • „Ich suche einen wummernden Synthesizer. Welche Möglichkeiten habe ich mit meinen bereits installierten Plugins?“

  • „Liste alle meine VST3-Plugins auf“

  • „Habe ich irgendwelche Reverb-Plugins?“

  • „Welche iZotope-Plugins habe ich?“

  • „Zeig mir alle meine Audio-Unit-Plugins“

  Hinweis: Dieses Werkzeug durchsucht deine Reaper-Plugin-Cache-Dateien. Wenn du kürzlich neue Plugins installiert und sie in Reaper noch nicht hast scannen lassen, erscheinen sie nicht in den Ergebnissen. Öffne Reaper also zuerst und lass es nach neuen Plugins scannen.

Audio-Analyse

• analyze_audio_files(project_path, track_filter=None, whole_file=False): Analysiert das Audio in einem Reaper-Projekt, um Mixing-Feedback zu liefern.

  Parameter:

  • project_path (erforderlich): Pfad zur .RPP-Projektdatei

  • track_filter (optional): Tracks nach Namen filtern (z. B. „Vocal“, um nur Gesangs-Tracks zu analysieren)

  • whole_file (optional): Statt nur der Region, die jedes Item abspielt, die gesamten Quelldateien analysieren. Standardmäßig deaktiviert.

  Rückgabe: Umfassende Audio-Analyse, einschließlich:

  • Pegelanalyse: Spitzenpegel, RMS, Clipping-Erkennung, DC-Offset

  • Frequenzanalyse: Spektraler Schwerpunkt und der Anteil jedes Bands an der Gesamtenergie

  • Stereo-Imaging: Stereo-Breite, Phasenkohärenz, Monokompatibilität

  • Dynamikumfang & Lautheit: LUFS (Lautheitsstandards), True Peak, Crestfaktor

  Beispielfragen:

  • „Analysiere das gesamte Audio in meinem Projekt ‚Rock Song‘“

  • „Überprüfe die Gesangs-Tracks auf Clipping“

  • „Ist mein Mix zu laut für Streaming-Plattformen?“

  • „Gibt es Phasenprobleme in meinen Drum-Tracks?“

  Was gemessen wird: Standardmäßig wird jedes Item genau über die Region analysiert, die es abspielt – über seinen Start-Offset in der Quelle, seine Länge und seine Playrate – und nicht über seine gesamte Quelldatei. Unterschiedliche Regionen werden einmal analysiert und wiederverwendet, sodass ein im Arrangement wiederholtes Item nur eine Messung kostet. MIDI-Items haben keine Audioquelle und werden unter skipped aufgeführt, statt als Fehler gemeldet zu werden.

  Frequenzwerte sind relativ. Jedes Band wird als Anteil an der gesamten spektralen Leistung der jeweiligen Region angegeben (derselbe Anteil auch in dB). Die absolute Bandenergie skaliert mit der Cliplänge, wodurch eine lange Datei um dutzende dB „heißer“ wirkt als eine kurze Datei mit identischem Material und ein Vergleich zwischen Dateien sinnlos wird.

  Diese Zahlen stammen aus dem Pre-FX-Signal. Die Analyse liest die Quelldateien von der Festplatte und spiegelt daher weder die FX-Kette des Tracks noch seinen Fader wider. Bei einem Track mit Amp-Simulation oder starkem EQ beschreibt die Analyse das rohe DI-Signal und nicht das, was du hörst. Jede Antwort ist mit signal_stage: pre-fx gekennzeichnet.

  Warnschwellen:

  • Peak > -0.3 dBFS: Clipping-Risiko

  • Clipping erkannt: Digitale Verzerrung vorhanden

  • 200–500 Hz mehr als 10 dB über 500–2000 Hz: Boxige tiefe Mitten. Dass diese beiden Bänder miteinander verglichen werden und nicht ein Band gegen das gesamte Spektrum, verhindert, dass eine Bass-Spur nur deshalb markiert wird, weil sie ein Bass ist.

  • Mittlerer Sample-Wert > 0.001: DC-Offset

  • Phasenkohärenz < 0.5: Probleme durch Phasenauslöschung

  • LUFS > -8: Zu laut für Streaming (Spotify-Zielwert: -14 LUFS)

  • Crestfaktor < 6 dB: Möglicherweise überkomprimiert

  Kann die Lautheit nicht gemessen werden (Regionen kürzer als 400 ms), wird sie als null ausgegeben, anstatt einen Ersatzwert zu verwenden. Regionen unter 50 ms werden zwar gemessen, aber nicht mit Warnungen belegt.

Um alle aus Projekten geparsten Datenstrukturen zu sehen, wirf einen Blick in die Datei src/reaper_mcp_server/reaper_dataclasses.py.

Related MCP server: AbletonMCP

Einrichtung

1. Abhängigkeiten installieren

   uv venv
   source .venv/bin/activate
   
   uv pip install .

2. Claude Desktop konfigurieren

   • Folge der Anleitung zur Konfiguration von Claude Desktop für die Verwendung mit einem eigenen MCP-Server

   • Die Beispielkonfiguration findest du in setup/claude_desktop_config.json

   • Aktualisiere die folgenden Pfade in der Konfiguration:

     • Den Pfad deiner uv-Installation

     • Dein Reaper-Projektverzeichnis

     • Das Verzeichnis dieses Servers

3. Starten und Konfigurieren

   • Öffne Claude Desktop

   • Klicke im Chatfeld auf das „+“-Symbol

   • Klicke auf „Connectors“, und du solltest den Connector „reaper“ aktiviert sehen

   

4. Frag drauflos!

   • Stelle Fragen zu deinem Reaper-Projekt

   • Gib immer den Namen des konkreten Reaper-Projekts an, über das du fragst

   • Du kannst die Tool-Boxen aufklappen, um die rohen Projektdaten zu sehen, die an Claude übergeben werden