Skip to main content
Glama

REAPER MCP 服务器

全面的模型上下文协议 (MCP) 服务器,使 AI 代理能够在 REAPER 中创建具有 MIDI 和音频功能的完全混合和掌握的曲目。

特征

  • 完整的项目管理(创建、保存、渲染)

  • 轨道操作(创建、路由、参数调整)

  • MIDI 创作和编辑

  • 音频录制和导入

  • 虚拟仪器和效果管理

  • 混合和自动化

  • 掌握工具

  • 音频分析和反馈

Related MCP server: REAPER MCP Server

要求

  • REAPER DAW 安装

  • Python 3.8+

  • REAPER 中启用 OSC 支持(用于 OSC 模式)

  • REAPER 中启用 ReaScript API(用于 ReaScript 模式)

安装

# Clone the repository
git clone https://github.com/itsuzef/reaper-mcp.git
cd reaper-mcp

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
pip install -e .

用法

快速入门

最简单的开始方式是使用提供的启动脚本:

# Start REAPER first
open /Applications/REAPER.app  # On macOS
# or start REAPER manually on other platforms

# Then start the MCP server
./scripts/start_reaper_mcp_server.sh  # On Unix/Mac

Windows 用户

对于 Windows 用户,请使用提供的 Windows 脚本之一:

# Using Command Prompt (CMD)
scripts\start_reaper_mcp_server.bat

# Using PowerShell
powershell -ExecutionPolicy Bypass -File scripts\start_reaper_mcp_server.ps1

配置

默认情况下,服务器将使用 OSC 模式,该模式更可靠,并且不需要 ReaScript API 正常工作。您可以使用命令行参数配置服务器:

# Start in OSC mode (default)
./scripts/start_reaper_mcp_server.sh --mode=osc  # Unix/Mac
scripts\start_reaper_mcp_server.bat --mode=osc   # Windows CMD
powershell -File scripts\start_reaper_mcp_server.ps1 -mode osc  # Windows PowerShell

# Start in ReaScript mode
./scripts/start_reaper_mcp_server.sh --mode=reapy  # Unix/Mac
scripts\start_reaper_mcp_server.bat --mode=reapy   # Windows CMD
powershell -File scripts\start_reaper_mcp_server.ps1 -mode reapy  # Windows PowerShell

# Configure OSC settings (Unix/Mac)
./scripts/start_reaper_mcp_server.sh --host=192.168.1.110 --send-port=8000 --receive-port=9000

# Configure OSC settings (Windows CMD)
scripts\start_reaper_mcp_server.bat --host=192.168.1.110 --send-port=8000 --receive-port=9000

# Configure OSC settings (Windows PowerShell)
powershell -File scripts\start_reaper_mcp_server.ps1 -host "192.168.1.110" -sendPort 8000 -receivePort 9000

# Enable debug logging
./scripts/start_reaper_mcp_server.sh --debug  # Unix/Mac
scripts\start_reaper_mcp_server.bat --debug   # Windows CMD
powershell -File scripts\start_reaper_mcp_server.ps1 -debug  # Windows PowerShell

为 OSC 设置 REAPER

  1. 打开 REAPER

  2. 前往“首选项”>“控制/OSC/web”

  3. 点击“添加”,选择“OSC(打开声音控制)”

  4. 配置以下设置:

    • 设备名称:ReaperMCP

    • 模式:本地端口

    • 本地监听端口:8000

    • 本地IP:127.0.0.1(或您计算机的IP地址)

    • 允许将消息绑定到 REAPER 操作和 FX 学习:选中(可选)

    • 传出最大数据包大小:1024

    • 数据包之间等待时间:10ms

为 ReaScript 设置 REAPER

  1. 打开 REAPER

  2. 转到“首选项”>“插件”>“ReaScript”

  3. 确保选中“为 ReaScript 启用 Python”

  4. 将 Python DLL/dylib 路径设置为 Python 安装

    • 在 macOS 上: /opt/homebrew/Cellar/python@3.x/3.xx/Frameworks/Python.framework/Versions/3.x/Python

    • 在 Windows 上: C:\Path\to\Python\python3x.dll

  5. 运行安装脚本:

    python scripts/setup_reaper_python.py

项目结构

  • src/reaper_mcp/ :主包目录

    • __main__.py :命令行界面

    • osc_server.py :基于OSC的服务器实现

    • server.py :基于 ReaScript 的服务器实现

  • examples/ :演示用法的示例脚本

  • scripts/ :用于设置和运行的实用程序脚本

MCP 工具

该服务器提供以下 MCP 工具:

  • create_project :创建一个新的 REAPER 项目

  • create_track :在当前项目中创建新的轨道

  • list_tracks :列出当前项目中的所有曲目

  • add_midi_note :向音轨添加 MIDI 音符

  • get_project_info :获取有关当前项目的信息

故障排除

ReaScript API 问题

如果您在使用 ReaScript API 时遇到问题,请尝试使用 OSC 模式:

./scripts/start_reaper_mcp_server.sh --mode=osc

OSC 通信问题

确保 REAPER 已针对 OSC 正确配置:

  1. 检查 REAPER 中的 OSC 设置是否与服务器设置匹配

  2. 确认没有防火墙阻止通信

  3. 尝试使用本地 IP 地址 (127.0.0.1) 而不是网络 IP

Windows 特定的故障排除

如果您在 Windows 上运行 MCP 服务器时遇到问题:

  1. 脚本执行问题:

    • 对于 PowerShell 脚本,您可能需要调整执行策略: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    • 或者,使用-ExecutionPolicy Bypass标志,如示例所示

  2. 路径问题:

    • 确保脚本中的 REAPER 路径与您的安装位置匹配

    • 默认为C:\Program Files\REAPER\reaper.exe ,可根据需要修改

  3. 虚拟环境:

    • 如果您使用不同的方法创建了 venv,则激活脚本可能位于不同的位置

    • 运行之前尝试手动激活: venv\Scripts\activate

  4. 防火墙阻止:

    • Windows 防火墙可能会阻止 OSC 通信

    • 在 Windows 防火墙设置中添加 Python 和 REAPER 的例外

  5. 管理员权限:

    • 如果遇到权限问题,请尝试以管理员身份运行命令提示符或 PowerShell

执照

麻省理工学院

Available Tools

61 tools
add_fxB

Add an FX plugin to a track. Works for both instruments (VSTi) and effects (VST/AU). Use the exact plugin name as shown in REAPER's FX browser. Built-in Cockos plugins: ReaEQ, ReaComp, ReaDelay, ReaVerb, ReaLimit, ReaSynth, ReaSamplOmatic5000, ReaTune, ReaGate, ReaFIR, ReaXcomp.

Inputs: fx_name (required), track_index (required).

add_master_fxC

Add an FX plugin to the master track.

Inputs: fx_name (required).

add_midi_noteB

Add a MIDI note to an existing MIDI item. pitch: MIDI note number 0–127 (60 = middle C, 69 = A4). start/length: seconds, relative to the item's start. channel: MIDI channel 0–15 (use 9 for drums).

Inputs: pitch (required), start (required), length (required), item_index (required), +3 more.

add_pan_automationC

Add a pan automation point on a track, showing its pan envelope if needed. pan: -1.0 (full left) to 1.0 (full right).

Inputs: pan (required), position (required), track_index (required).

add_volume_automationB

Add a volume automation point on a track, showing its volume envelope if needed. position: time in seconds. value_db: volume level in dB.

Inputs: position (required), value_db (required), track_index (required).

adjust_pitchB

Adjust the pitch of an audio item by semitones (can be fractional).

Inputs: semitones (required), item_index (required), track_index (required).

adjust_playback_rateC

Adjust playback rate of an audio item. 1.0 = normal speed, 0.5 = half speed.

Inputs: rate (required), item_index (required), track_index (required).

analyze_dynamicsB

Render the project and measure dynamic range: RMS, peak, crest factor, and a simplified DR score (average peak-to-RMS over 3-second blocks).

Inputs: no named parameters.

analyze_frequency_spectrumA

Render the project and analyze frequency band levels. Returns RMS level in dB for seven bands: sub_bass (20–60Hz), bass (60–250Hz), low_mids (250–500Hz), mids (500–2kHz), high_mids (2–4kHz), presence (4–8kHz), brilliance (8–20kHz).

Inputs: no named parameters.

analyze_loudnessA

Render the project to a temp file and measure integrated loudness (LUFS) and true peak (dBTP) using the ITU-R BS.1770 standard.

Inputs: no named parameters.

analyze_stereo_fieldA

Render the project and analyze stereo width and mono compatibility. Returns mid/side balance, stereo width ratio, and L/R correlation. Correlation near 1 = mono-like, near 0 = wide stereo, negative = phase issues.

Inputs: no named parameters.

analyze_transientsA

Render the project and detect transient events (note attacks, drum hits, etc.). Returns the count and timing of up to 100 transient onset events.

Inputs: no named parameters.

apply_limiterB

Add ReaLimit to the master track and set its threshold and release. threshold_db: -60 to +12 dB. release_db_per_sec: how fast gain reduction recovers, in dB per second as ReaLimit displays it (about 6 and up; higher recovers faster; default 15).

Inputs: threshold_db, release_db_per_sec.

apply_mastering_chainA

Add a standard mastering FX chain to the master track. Presets: default (EQ > Comp > Limiter), loud (EQ > Comp x2 > Limiter), gentle (EQ > light Comp > Limiter). After applying, use set_master_fx_parameter to dial in specific settings. Use list_master_fx + get_fx_parameters to discover parameter indices.

Inputs: preset.

bypass_fxB

Enable or bypass (disable) an FX plugin on a track.

Inputs: bypassed (required), fx_index (required), track_index (required).

create_busB

Create a new bus track and route the given tracks to it via sends. track_indices: list of track indices to feed into the bus.

Inputs: name (required), track_indices (required).

create_chord_progressionC

Create a chord progression on a track as a single MIDI item. chords: comma-separated chord names, e.g. "C,G,Am,F" or "Cm7,Fm7,Bb7,Ebmaj7". Supports: maj, min/m, dim, aug, maj7, min7/m7, dom7/7, dim7, hdim7, sus2, sus4. All chords are voiced around middle C (MIDI 60).

Inputs: chords (required), track_index (required), start_position (required), beats_per_chord.

create_drum_patternA

Create a drum pattern on a track using a step-sequencer string. Each character = one step. Characters: k=kick, s=snare, h=hihat(closed), o=hihat(open), t=tom(low), m=tom(mid), f=tom(high), c=crash, r=ride, .=rest. Example 4/4 rock beat (16 steps): "k...h...s...h..." All drum notes are placed on MIDI channel 9 (GM standard).

Inputs: pattern (required), track_index (required), start_position (required), beats, +1 more.

create_midi_itemC

Create an empty MIDI item on a track. Returns item_id for use with add_midi_note.

Inputs: length (required), track_index (required), start_position (required).

create_projectA

Create a new REAPER project, in a new project tab, with the given tempo and time signature. The current project stays open, unsaved changes included.

Inputs: name, tempo, time_signature.

create_sendC

Create an aux send from one track to another.

Inputs: dest_track_index (required), source_track_index (required), volume_db.

create_trackC

Create a new track at the end of the project. track_type: audio, midi, instrument, folder

Inputs: name (required), track_type.

delete_trackC

Delete a track by its index.

Inputs: track_index (required).

detect_clippingA

Render the project and detect digital clipping (samples at or above 0 dBFS). Returns clipped sample count, peak level in dB, and whether clipping was found.

Inputs: no named parameters.

edit_audio_itemB

Trim an audio item and/or add fades. All values in seconds. start_trim: seconds to remove from the beginning. end_trim: seconds to remove from the end. fade_in/fade_out: fade length in seconds.

Inputs: item_index (required), track_index (required), fade_in, end_trim, +2 more.

get_fx_parametersB

Get all parameters for an FX plugin, including names, indices, and current values.

Inputs: fx_index (required), track_index (required).

get_project_infoA

Get information about the current project: name, path, tempo, tracks, length.

Inputs: no named parameters.

get_track_infoC

Get detailed information about a track including FX and items.

Inputs: track_index (required).

import_audio_fileC

Import an audio file onto a track at the given position (seconds). Supports all formats REAPER can read: wav, aiff, mp3, flac, ogg, etc.

Inputs: file_path (required), track_index (required), position.

insert_track_templateA

Insert a saved track template into the current project, exactly like REAPER's own "Insert track from template": FX with their saved state, routing, folder structure, envelopes and items are all preserved. Templates can contain several tracks. template: a name or path from list_track_templates ("Vocal Chain", "Vocals/Lead Vox"), or an absolute path to a .RTrackTemplate file. position: 0-based track index the template's first track should occupy. Existing tracks at that index and below are shifted down. Omit to append at the end. The inserted tracks are left selected, matching REAPER's behaviour.

Inputs: template (required), position.

list_master_fxB

List all FX plugins on the master track.

Inputs: no named parameters.

list_sendsB

List all sends from a track.

Inputs: track_index (required).

list_track_fxB

List all FX plugins on a track.

Inputs: track_index (required).

list_tracksB

List all tracks in the current project with their basic parameters.

Inputs: no named parameters.

list_track_templatesA

List the track templates (.RTrackTemplate files) in REAPER's TrackTemplates folder, including subfolders. Each entry has 'name' (file name without extension), 'path' (relative to the TrackTemplates folder, e.g. "Vocals/Lead Vox"), the absolute 'file', and the names of the tracks the template contains. Pass either 'name' or 'path' to insert_track_template.

Inputs: no named parameters.

load_fx_presetC

Load a saved preset by name for an FX plugin.

Inputs: fx_index (required), preset_name (required), track_index (required).

load_projectB

Load a REAPER project (.rpp) from the given file path.

Inputs: project_path (required).

normalize_projectA

Measure the project's integrated loudness, then adjust the master volume so the output hits the target LUFS level. Common targets: -14 LUFS (streaming), -16 LUFS (podcasts), -23 LUFS (broadcast).

Inputs: target_lufs.

play_projectA

Start project playback from the current cursor position.

Inputs: no named parameters.

remove_fxC

Remove an FX plugin from a track by its index.

Inputs: fx_index (required), track_index (required).

remove_sendC

Remove a send from a track by its index.

Inputs: send_index (required), source_track_index (required).

rename_trackC

Rename a track.

Inputs: name (required), track_index (required).

render_projectB

Render the entire project to a file. format: wav, flac, mp3 (requires LAME), ogg. sample_rate: e.g. 44100, 48000, 96000. bit_depth: 16, 24, or 32 (WAV only; ignored for mp3/ogg/flac). channels: 1 (mono) or 2 (stereo).

Inputs: output_path (required), format, channels, bit_depth, +1 more.

render_regionsA

Render each region of the project to its own file, using the project's render settings. pattern: file name pattern; $region, $regionnumber, $project are available, and it may name subdirectories. REAPER numbers names that would clash ("take-001", "take-002"). selected_only: render only the regions selected in REAPER; with none selected, REAPER renders all of them. dry_run: return the project's regions and the files REAPER would write, without rendering. It sets the render settings and restores them. Fails without rendering if any output file already exists; never deletes files. Blocks until every file is written; status is then "complete". Gives up with "stalled" once the files stop growing for stall_timeout_seconds (longer while REAPER holds a scratch file), or "timeout" after timeout_seconds in total. Region "index" is the position among regions, as in get_project_info.

Inputs: output_directory (required), dry_run, pattern, selected_only, +2 more.

render_stemsA

Render each track as a separate stem file by soloing each track individually. track_indices: list of track indices, or null to render all tracks. Files are named after the track names in the output directory.

Inputs: output_directory (required), format, bit_depth, sample_rate, +1 more.

render_time_selectionB

Render a specific time range of the project to a file.

Inputs: end (required), start (required), output_path (required), format, +3 more.

save_projectA

Save the current project. If no path is given, saves to ~/Documents/REAPER Projects.

Inputs: project_path.

set_cursor_positionA

Move the edit cursor to a position in seconds.

Inputs: position (required).

set_fx_parameterA

Set a normalized parameter value (0.0–1.0) on an FX plugin. Use get_fx_parameters to discover available parameters and their indices.

Inputs: value (required), fx_index (required), param_index (required), track_index (required).

set_master_fx_parameterC

Set a normalized parameter (0.0–1.0) on a master track FX plugin.

Inputs: value (required), fx_index (required), param_index (required).

set_master_volumeB

Set the master track output volume in dB.

Inputs: volume_db (required).

set_send_volumeC

Set the volume of a send in dB.

Inputs: volume_db (required), send_index (required), source_track_index (required).

set_tempoB

Set the project tempo in BPM.

Inputs: bpm (required).

set_time_signatureB

Set the project time signature, e.g. 4/4, 3/4, 6/8.

Inputs: numerator (required), denominator (required).

set_track_colorB

Set track color using RGB values (0–255 each).

Inputs: b (required), g (required), r (required), track_index (required).

set_track_muteC

Mute or unmute a track.

Inputs: muted (required), track_index (required).

set_track_panA

Set track pan. -1.0 = full left, 0.0 = center, 1.0 = full right.

Inputs: pan (required), track_index (required).

set_track_soloC

Solo or unsolo a track.

Inputs: soloed (required), track_index (required).

set_track_volumeC

Set track volume in dB. Range: roughly -150 to +12 dB.

Inputs: volume_db (required), track_index (required).

start_recordingB

Arm a track and start recording. Call stop_transport when done.

Inputs: track_index (required).

stop_transportA

Stop playback or recording.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 61 tools

    Disambiguation4/5

    Most tools target clearly distinct resources and actions, and the descriptions make the intended use clear. There is some subtle overlap among master-FX tools (add_master_fx, apply_mastering_chain, apply_limiter) and among rendering/analysis families, but these are generally distinguishable by scope and output.

    Naming Consistency5/5

    Tool names consistently use snake_case verb_noun patterns such as create_track, set_track_volume, render_project, and analyze_loudness. The convention is predictable throughout, with no mixed casing or chaotic verb styles.

    Tool Count1/5

    At 61 tools this is an extreme surface for one MCP server, well beyond the typical ergonomic range even for a broad DAW domain. Many operations could be consolidated or grouped to reduce selection burden.

    Completeness4/5

    Coverage is strong across project lifecycle, tracks, FX, MIDI, audio import/edit, automation, transport, rendering, templates, and analysis. Minor gaps remain around deeper item editing, such as deleting/moving/splitting existing items or more advanced MIDI editing.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers