https://github.com/dschuler36/reaper-mcp-server

An MCP Server for interacting with Reaper projects.
https://github.com/dschuler36/reaper-mcp-server

Last synced: 2 months ago
JSON representation

An MCP Server for interacting with Reaper projects.

• Host: GitHub
• URL: https://github.com/dschuler36/reaper-mcp-server
• Owner: dschuler36
• License: mit
• Created: 2025-01-17T00:59:21.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-03-19T23:58:45.000Z (3 months ago)
• Last Synced: 2025-03-20T00:30:19.598Z (3 months ago)
• Language: Python
• Size: 1.08 MB
• Stars: 10
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-mcp-servers - Reaper - An MCP Server for interacting with Reaper projects. (Table of Contents / Other Tools and Integrations)
• awesome-mcp-servers - Reaper - An MCP Server for interacting with Reaper projects. (Table of Contents / Other Tools and Integrations)

README

        
# 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`

   

   ![Claude Desktop Tools](./docs/claude-desktop-tools.png)

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

   ![Claude Desktop Tools](./docs/example-question.png)