Reaper

What is Reaper MCP Server?

Reaper MCP Server is a simple Model Context Protocol (MCP) server designed to connect your Reaper (Digital Audio Workstation) projects with MCP clients, such as Claude Desktop. This integration allows AI models to interact with and understand the content of your Reaper projects, enabling you to ask questions about them.

How to use Reaper MCP Server?

1. Install Dependencies: Use uv to create a virtual environment and install project dependencies: uv venv, source .venv/bin/activate, uv pip install .
2. Configure Claude Desktop: Follow the instructions to configure Claude Desktop for a custom MCP server. Update the sample config (setup/claude_desktop_config.json) with your uv installation path, Reaper project directory, and the server's directory.
3. Launch and Configure: Open Claude Desktop. Verify that find_reaper_projects and parse_reaper_project tools are available by clicking the hammer icon in the bottom right of your chat box.
4. Ask Away!: Ask questions about your Reaper projects, always including the specific project name. You can expand tool boxes to view the raw project data.

Key Features of Reaper MCP Server

• find_reaper_projects: Locates all Reaper projects within a specified directory.
• parse_reaper_project: Parses a Reaper project and converts its data into a JSON object, making it machine-readable.
• Integration with MCP Clients: Seamlessly connects with MCP clients like Claude Desktop to extend AI capabilities to audio project analysis.

Use Cases of Reaper MCP Server

• AI-powered Project Analysis: Ask AI models questions about specific elements, tracks, or settings within your Reaper projects.
• Automated Project Information Retrieval: Quickly get information about your audio projects without manually opening them in Reaper.
• Enhanced Workflow for Audio Engineers: Leverage AI to assist in understanding and managing complex Reaper projects.

FAQ from Reaper MCP Server

• What is MCP? MCP (Model Context Protocol) allows AI models to interact with external tools and data, providing context for their responses.
• What kind of questions can I ask? You can ask questions about any data parsed from the Reaper project. Refer to src/domains/reaper_dataclasses.py to see all parsed data.
• Do I need Claude Desktop? While the documentation highlights Claude Desktop, Reaper MCP Server is designed to work with any compatible MCP client.

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