Reaper MCP Server

This is an MCP server that connects Reaper projects to an MCP client like Claude Desktop, enabling you to ask questions about your projects and get comprehensive audio analysis for mixing feedback.

Tools

Project Discovery & Parsing

• find_reaper_projects: Finds all Reaper projects in the directory you specified in the config.
• parse_reaper_project: Parses a Reaper project file (.RPP) and returns detailed information including tempo, tracks, FX chains, and audio items.

These tools work in tandem. When you ask Claude a question about a specific Reaper project, it will use the find_reaper_projects tool to find the project, then use the parse_reaper_project tool to parse the project and answer your question.

Audio Analysis

• analyze_audio_files(project_path, track_filter=None): Analyzes all audio files in a Reaper project for mixing feedback.

  Parameters:

  • project_path (required): Path to the .RPP project file
  • track_filter (optional): Filter tracks by name (e.g., "Vocal" to analyze only vocal tracks)

  Returns: Comprehensive audio analysis including:

  • Level Analysis: Peak levels, RMS, clipping detection
  • Frequency Analysis: Spectral content, energy distribution across frequency bands
  • Stereo Imaging: Stereo width, phase coherence, mono compatibility
  • Dynamic Range & Loudness: LUFS (loudness standards), true peak, crest factor

  Example Questions:

  • "Analyze all audio in my Rock Song project"
  • "Check the vocal tracks for clipping"
  • "Is my mix too loud for streaming platforms?"
  • "Are there any phase issues in my drum tracks?"

  Warning Thresholds:

  • Peak > -0.3 dBFS: Risk of clipping
  • Clipping detected: Digital distortion present
  • Excessive low frequency energy (> -6 dB): Muddy mix
  • Phase coherence < 0.5: Phase cancellation issues
  • LUFS > -8: Too loud for streaming (Spotify target: -14 LUFS)
  • Crest factor < 6 dB: Possibly over-compressed

To see all data structures parsed from projects, check out the src/reaper_mcp_server/reaper_dataclasses.py file.

Setup

1. Install Dependencies

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

2. Configure Claude Desktop

   • Follow the instructions to configure Claude Desktop for use with a custom MCP server
   • Find the sample config in setup/claude_desktop_config.json
   • Update the following paths in the config:
     • Your uv installation path
     • Your Reaper project directory
     • This server's directory

3. Launch and Configure

   • Open Claude Desktop
   • Look for the hammer icon in the bottom right of your chat box
   • Click the hammer icon to verify you see three Reaper tools available:
     • find_reaper_projects
     • parse_reaper_project
     • analyze_audio_files

   

4. Ask Away!

   • Ask questions about your Reaper project
   • Always include the name of the specific Reaper project you're asking about
   • You can expand the tool boxes to see the raw project data being passed to Claude