REAPER MCP Server

REAPER MCP 服务

一个 Model Context Protocol（MCP）服务，可让 AI Agent 控制 REAPER DAW，提供 61 个工具，涵盖项目管理、轨道、轨道模板、MIDI、FX、混音、母带处理、渲染和音频分析。

要求

• 已安装并正在运行的 REAPER 7 或更高版本
• Python 3.10+
• 已启用 REAPER 的远程 API（请参阅设置 REAPER）

安装

pip install reaper-mcp-server

或者从源代码安装：

git clone https://github.com/bonfire-systems/reaper-mcp.git
cd reaper-mcp
pip install -e .

设置 REAPER

服务通过 python-reapy 与 REAPER 通信，这要求启用 REAPER 的远程 API。

1. 打开 REAPER
2. 前往 Actions > Run ReaScript
3. 从此仓库中选择 scripts/enable_reapy.py（或创建一个新脚本，并填入以下内容）

   import reapy
   reapy.config.enable_dist_api()
   

4. 重启 REAPER

用法

使用 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "reaper": {
      "command": "reaper-mcp-server",
      "args": []
    }
  }
}

使用 Claude Code

claude mcp add reaper -- reaper-mcp-server

独立运行

reaper-mcp-server          # start the server
reaper-mcp-server --debug  # with debug logging

工具（60）

项目管理

create_project load_project save_project get_project_info set_tempo set_time_signature set_cursor_position play_project stop_transport

轨道

create_track delete_track rename_track list_tracks get_track_info set_track_color create_bus create_send remove_send list_sends

轨道模板

list_track_templates insert_track_template

从 REAPER 的 TrackTemplates 文件夹（包括子文件夹）中插入已保存的 .RTrackTemplate 文件，保留其原有的 FX 状态、路由、文件夹结构和素材，也可以指定轨道位置。

MIDI

create_midi_item add_midi_note create_chord_progression create_drum_pattern

FX 与乐器

add_fx remove_fx bypass_fx list_track_fx get_fx_parameters set_fx_parameter load_fx_preset add_master_fx list_master_fx set_master_fx_parameter

音频

import_audio_file edit_audio_item start_recording adjust_pitch adjust_playback_rate

混音

set_track_volume set_track_pan set_track_mute set_track_solo set_send_volume set_master_volume add_volume_automation add_pan_automation

渲染

render_project render_stems render_time_selection render_regions

母带处理

apply_mastering_chain apply_limiter normalize_project

分析

analyze_loudness analyze_dynamics analyze_frequency_spectrum analyze_stereo_field analyze_transients detect_clipping

贡献

请参阅 CONTRIBUTING.md。简而言之：每个拉取请求只处理一个问题，在真实的 REAPER 上进行测试（注明版本）；新增工具前先提交 issue。

许可证

MIT