Reaper Daemon

Reaper Daemon

Reaper Daemon は、AI エージェントから REAPER を操作するための REAPER MCP サーバー兼ファイルブリッジです。Claude やその他のエージェントを使ってセッションをミキシングできます。 ネットワークソケットもポートも拡張機能も必要ありません。

エージェントはフォルダーに JSON コマンドファイルを置きます。REAPER 内部の Lua スクリプトがそれを実行し、JSON の結果を書き戻します。プロトコルはこれだけです。 Claude Code、Codex、Cursor、その他ファイルの読み書きができるものなら何でも動作します。また、オプションの stdio MCP サーバー reaper_mcp.py を使うと、Claude Desktop やその他の MCP クライアント向けに、同じブリッジをツールとして公開できます。

macOS、Windows、Linux に対応しています。REAPER 内部では純粋な Lua、外部ではプレーンな Python 3 を使い、コアブリッジと MCP サーバーに pip パッケージは不要です。 オーディオからドラム MIDI へのトランスクリプションでは、別途オプションのモデル環境を使用します。すべての変更は REAPER の取り消しブロック内で実行されるため、Ctrl+Z ですべてのエージェント操作を元に戻せます。

インストール

Reaper Daemon は、REAPER 内で動作する Lua ブリッジと、それと通信するツールの 2 つで構成されます。どちらも REAPER が動作するコンピューター上でこのリポジトリをクローンして入手するため、Claude のプラグインディレクトリから見つけた場合でも、まずここでインストールしてください。

git clone https://github.com/wretcher207/reaper-daemon.git
cd reaper-daemon
python3 setup/install.py

REAPER を再起動し、ブリッジが動作していることを確認します。

python3 reaperd.py status

レンダリングとオーディオキャプチャは、許可するまで無効になっています。verify_change を含むすべての測定で必要です。許可するには、次を実行します。

python3 setup/install.py --allow-audio-writes

プロジェクトの保存、REAPER の環境設定の変更、Lua スクリプトの実行には、それぞれ個別のスイッチがあります。詳しくは docs/install.md をご覧ください。

ReaPack を使いたい場合や、ブリッジを手動で読み込みたい場合は、docs/install.md をご覧ください。

Claude プラグイン

このリポジトリは Claude プラグインでもあります。セットアップ、ドラムプログラミング、ドラムのヒューマナイズ、ギターとベースのパート、既存のアレンジ用 MIDI の 5 つのスキルと MCP サーバーが含まれています。このプラグインは上記のインストールを実行するため、インストール前に追加した場合は、Claude に Reaper Daemon のセットアップを依頼してください。セットアップスキルは不足しているものを確認し、クローンとインストーラーの実行を案内し、許可するディスクへの書き込みを尋ねたうえで、REAPER が応答することを確認します。

プラグインを追加すると、Claude は次の 2 つの設定を尋ねます。

• Reaper Daemon folder：クローン先のフォルダーです。デフォルトは ~/reaper-daemon です。
• Python command：デフォルトは python3 です。Windows で python3 が PATH にない場合は、python または py を使用してください。

Cowork では質問されないため、これらのデフォルト値が使われます。クローンから直接 Claude Code でプラグインを試すには、次を実行します。

claude --plugin-dir /path/to/reaper-daemon

MCP サーバーは REAPER と同じコンピューター上で動作します。お使いのマシンの Claude Code と Cowork のセッションで利用できます。claude.ai のチャットではスキルが読み込まれますが、REAPER には接続できません。

AI エージェントでミックスする

Claude、または Reaper Daemon と通信するエージェントを開いている REAPER セッションに接続し、ミックスの作業を依頼します。scan_fx ですべてのプラグインとパラメーターを読み取り、"-2.5 dB" のような実際の単位で FX の値を設定し、オートメーションを書き込みます。verify_change は変更の前後でトラックをキャプチャし、オーディオに何が変化したかを報告するため、エージェントの言葉を鵜呑みにする必要はありません。すべての操作は REAPER の取り消しブロック内で行われ、最終判断は自分の耳で行えます。

プロンプトの例：

• 「300 Hz 付近のベースの濁りを抑えてください。」
• 「ボーカルが前に出すぎず、ミックスになじむように音量を下げてください。」
• 「ベースの LUFS が 3 dB 下がるまで調整してください。」
• 「ドラムバスにはどんなプラグインがあり、それぞれどのように設定されていますか？」

セットアップについては MCP サーバー、測定で何が証明でき、何が証明できないかについては 検証 をご覧ください。

できること

領域	コマンド
プロジェクト	トランスポート、テンポとテンポマップ、カーソル、時間選択、レンダー、保存
トラック	追加、削除、名前変更、選択、音量、パン、ミュート、ソロ、録音待機、色
ルーティング	センドとレシーブの読み取り、センドの作成、マスターフィードの切り替え
FX	追加、削除、バイパス、並べ替え、パラメーター設定、オートメーション作成、チェーンの保存
マーカー、リージョン、メディアアイテム	完全な読み取りと書き込み
MIDI	MIDI ファイルの挿入と、ヒューマナイズ機能を備えたドラム DSL
トランスクリプション	オプションのローカル解析ランタイムを使用して、オーディオアイテムをドラム MIDI に変換
ギターとベース	shred は人間らしいリフをレンダーし、band はリズムセクション全体を作成
検出	scan_fx はすべてのプラグインとパラメーターを出力し、discover_drum_map は任意のキットのノートマップを読み取ります
検証	ミックスの変更前後のラウドネス、スペクトル、ダイナミクスを測定
アクションとスクリプト	REAPER のアクションリストにある項目を検索して実行。専用スイッチの背後で、ソースまたはパスから Lua を実行

ブリッジは特定のプラグインやドラムライブラリについての情報を持ちません。エージェントはプロジェクトの内容を検出し、名前を指定して操作します。

接続方法は 3 つ

CLI。 エージェントが行うすべての操作を実行できる、単一の Python エントリーポイントです。

python3 reaperd.py send commands/examples/get_context.json --wait
python3 reaperd.py shred --track argent-l --bars-file riff.txt --seed 101

MCP サーバー。 reaper_mcp.py はブリッジを、stdio 経由でツールとして提供します。 Claude Desktop に「ドラムを測定して」と頼めば、実行してくれます。

Daemon Console。 REAPER 内にドッキングされるチャットパネルです。選択中のトラックを常に把握する、ヘッドレスの Claude Code セッションを利用します。

ドキュメント

インストール	ワンラインインストーラー、ReaPack、手動読み込み
CLI	reaperd.py リファレンス
MCP サーバー	Claude Desktop およびその他のクライアント向けセットアップ
Daemon Console	REAPER 内のチャットパネル
ドラム	キットの検出、ステムのプロファイリング、ヒューマナイズ
作曲ワークフロー	サンプリング音源でフル楽曲を制作する方法：測定、アーティキュレーション、シンバルの変化付け、検証
ドラム制作ワークショップ	独立した作曲ブリーフ、MIDI の比較、対象を絞った試聴フィードバック
ドラムのトランスクリプション	オーディオから MIDI への変換、バックグラウンドジョブ、キットのマッピング
ギターとベース	shred と band
ミックスレシピ	ミックス設定の記録、比較、再構築
検証	測定による証拠を伴う閉ループのミックス調整
プロトコル	ファイルのワイヤーフォーマット
トラブルシューティング	無音のキャプチャ、古いハートビート
ウォッチドッグ	無人実行：REAPER の再起動、ダイアログ、古いキューファイル
ソングプランナー	音源ライブラリ、ソングシート、承認済みドラフト
セキュリティ	信頼モデルとオプションのトークン
開発	テスト、CI、リポジトリの構成

エージェントは AGENTS.md、CLAUDE.md、bridge/command_schema.md を読む必要があります。同梱されている 2 つのスキル、arrangement-midi と drum-humanize では、MIDI の作曲とドラムのヒューマナイズを扱います。song-planner は、ブリーフ、リフ、または参考音源をもとに楽曲全体を計画し、ドラフトを作成します。

セキュリティ

inbox/ への書き込みが可能なプロセスは、どれも REAPER を操作できます。ブリッジのフォルダーはローカルに保管し、共有ドライブには置かないでください。詳しくは docs/security.md をご覧ください。

実行内容と送信内容

すべてお使いのマシン上で実行されます。MCP サーバーと CLI は通常の Python で実装されており、ネットワーク通信は行いません。ブリッジは REAPER 内で実行される Lua スクリプトです。Reaper Daemon フォルダーを介してサーバーと JSON ファイルをやり取りします。このフォルダーには、ログと生成された MIDI ファイルも保存されます。レンダリングとキャプチャでオーディオファイルが書き出されるのは、オーディオ書き込みを有効にした場合のみです。デフォルトでは無効になっています。お使いのコンピューターの外にデータが送信されることはありません。

追加の機能を実行するオプションのコンポーネントが 3 つあります。いずれもインストールした場合にのみ動作します。

• ドラムのトランスクリプションでは、セットアップ中に Python パッケージとモデルの重みをダウンロードし、Demucs では最初の分離処理時に重みをダウンロードします。 オーディオはローカルに保持されます。
• analyze_track と compare_tracks は、PATH から Post Mortem を実行します。
• Daemon Console は、お使いのマシンで Claude Code のセッションを開始します。このセッションは、他の Claude Code セッションと同様に Anthropic と通信します。

ライセンス

MIT です。LICENSE をご覧ください。

キーボード演奏のセットアップ、MIDI／コントローラーテスト、テンプレートの保存については、演奏ワークフローに記載されています。