Reaper Project Analyzer MCP Server

Developer ToolsPython

Analyze and query Reaper digital audio workstation projects

Available Tools

find_reaper_projects

Finds all Reaper projects in the directory specified in the configuration

parse_reaper_project

Parses a Reaper project file and returns a structured JSON object with project details

The Reaper Project Analyzer provides a seamless connection between your Reaper digital audio workstation projects and AI assistants like Claude. This tool enables you to ask natural language questions about your audio projects, analyze track structures, and get insights about your music production work without leaving your creative environment. By parsing Reaper project files into structured data, this integration allows AI assistants to understand the complex relationships between tracks, effects, and other elements in your audio projects. This makes it easier to troubleshoot issues, understand project organization, and get recommendations for your music production workflow.

Overview

The Reaper Project Analyzer is an MCP server that connects your Reaper digital audio workstation projects to AI assistants like Claude Desktop. It allows you to ask questions about your projects and get detailed information about tracks, effects, and other elements.

Installation

First, ensure you have Python installed on your system.

Clone the repository:

git clone https://github.com/dschuler36/reaper-mcp-server.git
cd reaper-mcp-server

Create a virtual environment and install dependencies:
```
uv venv
source .venv/bin/activate
uv pip install .
```
Configure your AI assistant (e.g., Claude Desktop) to use this MCP server by adding the configuration to your assistant's settings.

Configuration

To configure Claude Desktop to work with this MCP server:

Follow the instructions to configure Claude Desktop for use with a custom MCP server at: https://modelcontextprotocol.io/quickstart/server#core-mcp-concepts
Use the sample configuration in setup/claude_desktop_config.json as a template.
Update the following paths in the configuration:
- Your uv installation path
- Your Reaper project directory
- The directory where you installed this server

Usage

Launch Claude Desktop after configuring it to use this MCP server.
Look for the hammer icon in the bottom right of your chat box and click it to verify that you see the Reaper tools available.
When asking questions about your Reaper projects, always include the specific project name in your query. For example:
- "What tracks are in my 'Summer Song' project?"
- "How many audio effects are on the vocal track in 'Demo Recording'?"
- "What's the BPM of my 'Band Practice' project?"
You can expand the tool boxes in Claude Desktop to see the raw project data being passed to the AI assistant.

Troubleshooting

If you encounter issues:

Ensure your Reaper project directory path is correctly specified in the configuration.
Verify that the MCP server is running properly.
Check that Claude Desktop is properly configured to use the custom MCP server.
Make sure you're specifying the correct project name in your queries.