Reaper MCP Server
by dschuler36
# 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**
```bash
uv venv
source .venv/bin/activate
uv pip install .
```
2. **Configure Claude Desktop**
- Follow [the instructions to configure Claude Desktop](https://modelcontextprotocol.io/quickstart/server#core-mcp-concepts) 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
