📌Overview

Purpose: To connect a Reaper project with an MCP client like Claude Desktop for enhanced interaction and querying capabilities about the project.

Overview: The Reaper MCP Server serves as a bridge between Reaper projects and the Claude Desktop client, enabling users to ask detailed questions regarding their music projects. By utilizing specific tools, it facilitates project discovery and data parsing, making project information readily accessible.

Key Features:

• find_reaper_projects: This tool locates all Reaper projects in the specified directory, ensuring users can easily access their work within Claude Desktop.

• parse_reaper_project: This tool converts selected Reaper projects into a JSON format, allowing for structured queries and insightful responses to user questions regarding the project's details.

---

Reaper MCP Server

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

Tools

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

These tools work together: when you ask Claude a question about a specific Reaper project, it uses find_reaper_projects to locate the project, then parse_reaper_project to parse it and answer your question. To see all parsed data from the project, check 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: https://modelcontextprotocol.io/quickstart/server#core-mcp-concepts
   • 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