内容
# REAPER MCP 服务器
一款模型上下文协议（MCP）服务器，能够使 AI 代理控制 REAPER DAW — 58 种工具涵盖项目管理、音轨、MIDI、特效、混音、母带、渲染和音频分析。
## 要求
- [REAPER](https://www.reaper.fm/) DAW 已安装并运行
- Python 3.10+
- REAPER 的远程 API 已启用（参见 [设置 REAPER](#设置-reaper)）
## 安装
```bash
pip install reaper-mcp-server
```
或从源码安装：
```bash
git clone https://github.com/bonfire-systems/reaper-mcp.git
cd reaper-mcp
pip install -e .
```
## 设置 REAPER
服务器通过 [python-reapy](https://github.com/RomeoDespres/reapy) 与 REAPER 通信，这需要启用 REAPER 的远程 API。
1. 打开 REAPER
2. 进入 操作 > 运行 ReaScript
3. 从此仓库中选择 `scripts/enable_reapy.py`（或使用以下内容创建新脚本）
```python
import reapy
reapy.config.enable_dist_api()
```
4. 重启 REAPER
## 使用
### 与 Claude Desktop 结合使用
在您的 Claude Desktop 配置文件（`claude_desktop_config.json`）中添加：
```json
{
"mcpServers": {
"reaper": {
"command": "reaper-mcp-server",
"args": []
}
}
}
```
### 与 Claude Code 结合使用
```bash
claude mcp add reaper -- reaper-mcp-server
```
### 独立使用
```bash
reaper-mcp-server # 启动服务器
reaper-mcp-server --debug # 开启调试日志
```
## 工具（58）
### 项目管理
`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`
### MIDI
`create_midi_item` `add_midi_note` `create_chord_progression` `create_drum_pattern`
### 特效与乐器
`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`
### 母带
`apply_mastering_chain` `apply_limiter` `normalize_project`
### 分析
`analyze_loudness` `analyze_dynamics` `analyze_frequency_spectrum` `analyze_stereo_field` `analyze_transients` `detect_clipping`
## 配置
服务器将其配置存储在您平台的配置文件目录中：
- macOS: `~/Library/Application Support/reaper-mcp/config.json`
- Linux: `~/.config/reaper-mcp/config.json`
- Windows: `%APPDATA%\reaper-mcp\config.json`
## 许可证
MIT
