Reaper MCP Server

- Finds all Reaper projects in a specified directory.
- Parses a Reaper project into a JSON object.
- Works with MCP clients like Claude Desktop.
- Enables natural language questions about Reaper projects.
- Two tools work together to answer queries.

1. 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

2. 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

3. Start Using
- 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

- 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.