Skip to content

About

MCP server for controlling REAPER DAW through Python scripts.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

About

MCP server for controlling REAPER DAW through Python scripts. It communicates with the lua server from ReaScript-Socket-Example - run api_server.lua in REAPER to establish the connection.

TL;DR: This enables AI to generate Python code that uses MCP to call Lua-style ReaScript APIs, executing Lua ReaScript commands in REAPER. This approach combines Python's versatility with the popularity of Lua ReaScript APIs.

Example usage

  1. Create tracks
  2. Set track colors in a cycle loop

Running

This project runs with uv Python. Start the server:

# In the project directory
uv run reaper_mcp

# Or with directory path
uv run --directory /path/to/reaper_mcp reaper_mcp

To run MCP in agent programs such as OpenCode, you need to edit the configuration file. For example:

"reaper": {
  "type": "local",
  "enabled": false,
  "command": [
    "uv",
    "run",
    "--directory",
    "/path",
    "reaper_mcp"
  ]
}

The configuration varies for different programs.

SKILLS Directory

The SKILLS/ directory contains skill definition files for REAPER operations. These files are written in Chinese (my native language is Chinese) and provide instructions for specialized REAPER tasks. I believe the translated English versions would have the same effectiveness.

To use these skills, copy them to the corresponding directory of your software. For example, with OpenCode:

cp -r SKILLS/* ~/.opencode/skills/

Available Skills

  • reaper-track - Track operations and management (create, edit, configure, traverse, statistics, color)
  • reaper-color - Color operations (RGB conversion to REAPER system colors)

About

MCP server for controlling REAPER DAW through Python scripts.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Contributors

Languages