REAPER MCP Server

REAPER MCP Server

AI エージェントが REAPER DAW を操作できるようにする Model Context Protocol（MCP）サーバーです。プロジェクト管理、トラック、トラックテンプレート、MIDI、FX、ミキシング、マスタリング、レンダリング、オーディオ分析をカバーする 61 個のツールを備えています。

要件

• REAPER 7 以降がインストールされ、実行されていること
• Python 3.10+
• REAPER の distant API が有効になっていること（セットアップを参照）

インストール

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 の distant 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 を参照してください。要点は、1 件のプルリクエストにつき 1 つの変更内容とすること、実際の REAPER でテストすること（バージョンを明記してください）、新しいツールを追加する場合は事前に Issue を作成することです。

ライセンス

MIT