# reaper-mcp-server

> MCP Server

This repository provides a simple MCP server that connects a Reaper project to an MCP client like Claude Desktop, enabling users to ask questions about their projects. It uses tools

## Overview

- **Category:** Developer Tools
- **Language:** Python
- **Stars:** 116
- **Forks:** 1
- **Owner:** dschuler36
- **GitHub:** https://github.com/dschuler36/reaper-mcp-server
- **Created:** 2025-01-17T00:59:21+00:00
- **Updated:** 2025-03-28T17:21:00+00:00
- **Source:** https://model-context-protocol.com/servers/reaper-mcp-server-project-question-answering

## Setup

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

## Tools

## Available Tools

		1. `find_reaper_projects` (Finds all Reaper projects in the directory you specified in the config.)
		2. `parse_reaper_project` (Parses a Reaper project and returns a JSON object.)