Reaper and MCP or AI integration

A Python application for controlling REAPER Digital Audio Workstation (DAW) using the MCP(Model context protocol).

Features

• Track Management: Create, rename, and color tracks
• FX Management: Add, remove, and control effect parameters
• Project Control: Set tempo, manage regions and markers
• Master Track Control: Volume, pan, mute, and solo operations
• MIDI Operations: Create items, add/get notes, clear items with musical positioning
• Audio Item Operations: Insert, duplicate, modify with enhanced positioning support
• Dual Position Format: Support both time (seconds) and measure:beat notation
• Reliable Duplication: Uses REAPER's built-in commands for accurate item copying
• MCP Integration: Model Context Protocol server for AI assistant control

Requirements

• Python 3.7+
• REAPER DAW
• python-reapy Python module
• mcp[cli] package for MCP server
• Internet connection (for downloading sample audio file)

Installation

1. Install REAPER if you haven't already
2. Enable reapy server via REAPER scripting add reaper_side_enable_server.py to reaper actions and run it inside reaper studio
3. Install the package:

   # From PyPI
   pip install reaper_reapy_mcp
   
   # From GitHub repository
   pip install git+https://github.com/wegitor/reaper-reapy-mcp.git
   

4. Enable python in REAPER

The wheel package includes all necessary dependencies and can be used in other Python projects that need REAPER integration. The project uses pyproject.toml for modern Python packaging configuration, which provides better dependency management and build system configuration.

Sample Audio File

The application uses a sample MP3 file for testing audio operations. The file will be automatically downloaded when needed from:

https://www2.cs.uic.edu/~i101/SoundFiles/StarWars3.mp3

This is a short Star Wars theme clip that's commonly used for testing audio applications.

Running the Server

You can run the server using uv directly:

uv --directory <project_path> run -m reaper_reapy_mcp

For example, on Windows:

uv --directory C:\path\to\reaper_reapy_mcp run -m reaper_reapy_mcp

Or using the Python module directly after installation:

python -m reaper_reapy_mcp

Use the MCP inspector to test the tools:

test_mcp.bat

Available MCP tools:

Track Management

• test_connection: Verify connection to REAPER
• create_track: Create a new track
• rename_track: Rename an existing track
• set_track_color: Set track color
• get_track_color: Get track color
• get_track_count: Get number of tracks in project
• get_track_list: Get list of all tracks with their properties

FX Management

• add_fx: Add an FX to a track
• remove_fx: Remove an FX from a track
• set_fx_param: Set FX parameter value
• get_fx_param: Get FX parameter value
• get_fx_param_list: Get list of FX parameters
• get_fx_list: Get list of FX on a track
• get_available_fx_list: Get list of available FX plugins
• toggle_fx: Toggle FX enable/disable state

Project Control

• set_tempo: Set project tempo
• get_tempo: Get current tempo
• get_time_signature: Get current time signature
• set_project_time_signature: Set project default time signature
• set_time_signature: Set time signature at position
• create_region: Create a region
• delete_region: Delete a region
• create_marker: Create a marker
• delete_marker: Delete a marker
• render_project: Render project to audio file

Master Track

• get_master_track: Get master track information
• set_master_volume: Set master track volume
• set_master_pan: Set master track pan
• toggle_master_mute: Toggle master track mute
• toggle_master_solo: Toggle maste

... View full README on GitHub