What is Reaper

The Reaper MCP Server is a tool designed to connect a Reaper project with an MCP client, like Claude Desktop, allowing users to interact with and inquire about their Reaper projects effectively.

Use cases

It enables users to ask detailed questions regarding specific Reaper projects, offering insights into project structure, audio tracks, effects, and other components. This facilitates project management and enhances the user experience while working with audio editing and mixing.

How to use

Users need to install dependencies, configure Claude Desktop with relevant paths, and launch the application. After launching, they can verify the available tools and start asking questions about specific Reaper projects within Claude Desktop’s interface.

Key features

Key features include the ability to find Reaper projects in specified directories and parse project files to return structured JSON data. This data can help users understand the intricacies of their audio projects and offers a streamlined method for retrieving information.

Where to use

This server is intended for use alongside the Reaper digital audio workstation (DAW) and can be utilized by audio engineers, producers, and musicians who need to extract and manipulate project data easily within a collaborative environment.

Reaper MCP Server

This is a simple MCP server that connects a Reaper project to an MCP client like Claude Desktop and enables you to ask questions about the project.

Tools

• find_reaper_projects: Finds all Reaper projects in the directory you specified in the config.
• parse_reaper_project: Parses a Reaper project and returns a JSON object.

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. To see all data that is parsed from the project, check out the src/domains/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 two Reaper tools available:
     • find_reaper_projects
     • parse_reaper_project

   

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