Summary

reaper-reapy-mcp is a Python application that enables control of the REAPER Digital Audio Workstation via the Model Context Protocol (MCP). It allows automation and interaction with REAPER features such as track management, effect handling, project control, MIDI and audio item operations.

Features

• Track Management: create, rename, color tracks
• FX Management: add, remove, control FX parameters and toggle FX state
• Project Control: set tempo, manage regions and markers, render project
• Master Track Control: volume, pan, mute, solo
• MIDI Operations: create MIDI items, add/get notes, clear items with support for musical positioning
• Audio Item Operations: insert, duplicate, modify audio items with time and measure:beat positioning support
• Dual Position Format Support: time (seconds) and musical measure:beat notation supported
• Reliable duplication using REAPER's built-in commands
• MCP server support for AI assistant integration via HTTP or stdio

Requirements and Installation

• Python 3.7 or higher
• REAPER DAW installed
• python-reapy module
• mcp[cli] package for MCP server
• Internet connection to download a sample audio file

Installation can be done from PyPI or directly from GitHub. The REAPER scripting server needs to be enabled by running a provided script inside REAPER.

Usage

The server can be run using the uv tool or directly via Python with options for HTTP mode and custom host/port. It provides an MCP inspector and test tools for various REAPER functions.

Development and Contribution

The project is open source under the MIT License. Contributions via pull requests are welcome.