Atlas / MCP servers / shiehn / Total Reaper

Total ReaperCAUTION

Name: Total Reaper
Author: shiehn

mcp/shiehn/total-reaper

MCP server by shiehn · Audited 2026-10-08

⚑ Report / re-scan Source ↗

Reaper DAW MCP Server with 100% Reascript Coverage

Verdict

CAUTION

Grade

Trust score

81 /100

Exposed tools

48 33r · 12w · 3d

Transport

stdio

License

MIT

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

An MCP (Model Context Protocol) server that exposes REAPER DAW functionality through a clean API interface.

Platform Support

This project is developed and tested on macOS but should work on Windows and Linux with minimal adaptation, as REAPER provides consistent cross-platform support.

Requirements

REAPER 6.83+ (includes embedded Lua 5.4 and full ReaScript API)
Python 3.10+ (required for MCP 1.1.2+)
LuaSocket library (optional - only needed for socket-based communication)

Architecture

This project uses a hybrid Lua-Python approach:

Lua Bridge: Runs inside REAPER, handles API calls using REAPER's built-in Lua interpreter
Python MCP Server: Provides the MCP interface, communicates with REAPER via file-based IPC

The communication flow:

MCP client sends request → Python server
Python server writes JSON file → Bridge directory
Lua bridge reads file → Executes REAPER API
Lua bridge writes response → Bridge directory
Python server reads response → Returns to MCP client

Quick Start

For AI/LLM Integration (Recommended)

# Start with default profile (dsl-production: 53 tools)
# Includes natural language DSL + essential production tools
python -m server.app

# Or choose a specific profile:
python -m server.app --profile dsl              # Minimal natural language only (15 tools)
python -m server.app --profile groq-essential   # Traditional ReaScript tools (146 tools)
python -m server.app --profile full             # All tools (600+ tools)

The default dsl-production profile is optimized for AI/LLM use, providing natural language commands plus essential MIDI, FX, and rendering tools.

Quick Install (macOS)

./scripts/install.sh

This will:

Install the Lua bridge to REAPER's Scripts folder
Configure REAPER to load the bridge on startup
Set up Python virtual

Read from source at commit 3d8844cc6fb9OBSERVED · 2026-10-08

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add reaper-mcp-server --env MCP_AUTH_TOKEN=${MCP_AUTH_TOKEN} --env OPENAI_API_KEY=${OPENAI_API_KEY} -- uvx reaper-mcp-server

claude-desktop

{
  "mcpServers": {
    "reaper-mcp-server": {
      "command": "uvx",
      "args": [
        "reaper-mcp-server"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "${MCP_AUTH_TOKEN}",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
      }
    }
  }
}

Exposed tools (48)

33 read · 12 write · 3 destructive. Blast radius: 3 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

Tool	Risk	Description
`dsl_add_effect`	write
`dsl_adjust_effect`	read
`dsl_automate`	read
`dsl_automate_section`	read
`dsl_continue`	read
`dsl_create_bus`	write
`dsl_create_send`	write
`dsl_effect_bypass`	read
`dsl_enhance`	read
`dsl_fade`	read
`dsl_generate`	read
`dsl_get_tempo_info`	read
`dsl_go_to`	read
`dsl_group_tracks`	read
`dsl_item_copy_paste`	read
`dsl_list_tracks`	read	Show what\
`dsl_loop_create`	write
`dsl_marker`	read
`dsl_midi_insert`	write
`dsl_normalize`	read
`dsl_play`	read
`dsl_quantize`	read
`dsl_record`	read
`dsl_region`	read
`dsl_render`	read
`dsl_reset_context`	destructive
`dsl_reverse`	read
`dsl_save`	write
`dsl_select`	read
`dsl_send`	write
`dsl_set_tempo`	write
`dsl_split`	read
`dsl_stop`	write
`dsl_time_select`	read
`dsl_track_arm`	read
`dsl_track_color`	read
`dsl_track_create`	write	Add a new instrument, voice, or sound to your project.
`dsl_track_delete`	destructive
`dsl_track_delete_all`	destructive
`dsl_track_duplicate`	read
`dsl_track_mute`	read
`dsl_track_pan`	read
`dsl_track_rename`	write
`dsl_track_solo`	read
`dsl_track_volume`	read	Make sounds louder or quieter.
`dsl_undo`	read
`enable_capability`	write
`list_capabilities`	read

Trust audit

CAUTIONgrade B · trust 81/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	WARN
L1	Static analysis of the code	WARN
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	WARN
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (4 observation(s))
Network: declared (7 observation(s))
Shell: none-observed
Dependencies: pinned
Secrets in source: none-found