Skip to main content
Glama

REAPER MCP 서버

AI 에이전트가 MIDI 및 오디오 기능을 모두 갖춘 REAPER에서 완벽하게 믹싱 및 마스터링된 트랙을 생성할 수 있도록 하는 포괄적인 MCP(Model Context Protocol) 서버입니다.

특징

  • 프로젝트 관리 완료(생성, 저장, 렌더링)

  • 작업 추적(생성, 라우팅, 매개변수 조정)

  • MIDI 작곡 및 편집

  • 오디오 녹음 및 가져오기

  • 가상 악기 및 효과 관리

  • 믹싱 및 자동화

  • 도구 마스터링

  • 오디오 분석 및 피드백

Related MCP server: REAPER MCP Server

요구 사항

  • REAPER DAW 설치됨

  • 파이썬 3.8 이상

  • REAPER에서 OSC 지원이 활성화됨(OSC 모드용)

  • REAPER에서 ReaScript API 활성화(ReaScript 모드용)

설치

지엑스피1

용법

빠른 시작

시작하는 가장 쉬운 방법은 제공된 시작 스크립트를 사용하는 것입니다.

# 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 스크립트 중 하나를 사용하세요.

# 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/웹으로 이동하세요

  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 대신 로컬 IP 주소(127.0.0.1)를 사용해 보세요.

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을 관리자 권한으로 실행해 보세요.

특허

MIT

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