Audio Calibration MCP

Audio Calibration MCP

Audio Calibration MCP は、Room EQ Wizard（REW）向けのローカルファーストなクロスプラットフォームの Model Context Protocol サーバーです。一般的なオーディオシステム、パワードスピーカー、車載オーディオ、ノート PC を対象に、音響測定、スピーカーと 部屋のキャリブレーション、サブウーファーとクロスオーバーの分析、控えめな EQ、DSP への適用、測定による検証を支援します。

REW と同じコンピューターで、Codex、Claude Code、Cursor などの AI アシスタントから使用できます。MCP はアシスタントがこれらのツールを呼び出すための接続であり、 このプロジェクト自体は独立したキャリブレーションアプリではありません。測定は REW が行い、DSP またはレシーバーが対応する変更を適用します。

このプロジェクトは、誰にとっても「完璧な」サウンドを実現できるとは約束しません。REW で音響システムを測定することはできますが、 根拠がなければ、リスナーの好み、マイクの配置、スピーカーの安全な出力能力を推測することはできません。MCP は不足しているデータを報告し、 好みと工学的な計算を分けて扱います。

まずはこちら

MCP を初めて使いますか？ガイドをご覧ください。必要なもの、ツールのインストールと接続方法、最初の REW 測定を分析する方法を説明しています。すでにある測定データから始めることもできます。

• Codex、Claude Code、または Cursor にインストールする
• ビフォーアフター：測定例とその限界
• トラブルシューティング

この MCP は無料のオープンソースです。選択したアシスタントには、それぞれ独自のアカウントと課金要件があります。API 経由で REW のスイープを自動実行するには REW Pro ライセンスが必要ですが、既存の測定データを読み込む場合、自動スイープ制御は必要ありません。REW の API ドキュメントをご覧ください。

適切なオーディオ MCP を選ぶ

次の用途にはこのプロジェクトを使用	次の用途には EvoBurrow MCP を使用
一般的な REW 音響測定と、根拠に基づく EQ	A1 Evo AcoustiX アーティファクトの検査またはターミナルのワークフロー
部屋、スピーカー、サブウーファー、車載オーディオ、パワードスピーカー、またはノート PC のキャリブレーション	Denon／Marantz AVR のステータス、プリセットのマッピング、バックアップ、または安全策を備えた LAN 制御
JamesDSP、CamillaDSP、Equalizer APO、FIR、またはリスニングテストのワークフロー	現在のレシーバー状態に紐づけた Audyssey .ady／.oca の確認

両プロジェクトは測定に関する方針を共有していますが、この MCP は意図的にハードウェアに依存しない設計です。A1 および AVR 固有の安全対策は EvoBurrow が担います。

実測したノート PC の例 — 調整前と調整後

これは、各状態で REW スイープを 4 回繰り返して測定し、1/12 オクターブ平滑化で平均した実測データです。工場出荷時の設定はアンバー、カットのみを適用した JamesDSP のプリセットはシアンで示しています。500 Hz 未満の網掛け部分は、保護上の制限によりブーストを適用していない低音域を示します。グラフには実測 SPL をそのまま示しており、好みは別途、音量を一致させた試聴比較で評価しました。デバイス、マイク、プリセットの識別情報は、公開データから意図的に削除しています。

このグラフが示すこと、示さないこと、ご自身のシステムで変更を比較する方法については、この例の解説をご覧ください。

互換性

コンポーネント	対応状況
Node.js	20 および 22
オペレーティングシステム	Windows x64、macOS Intel/Apple Silicon、Linux x64/ARM64
REW	ポート 4735 のローカル API、クロスプラットフォームのインストール検出と起動確認
JamesDSP	Linux/JDSP4Linux の検査、プレビュー、バックアップ、適用、検証、ロールバック、ブラインドで音量を一致させた A/B 比較
Equalizer APO	エクスポート。明示的に設定パスを指定した場合に限り、安全対策付きで適用
CamillaDSP	YAML エクスポート。明示的に設定した場合に限り、安全対策付きでファイルに適用
miniDSP	REW 対応のテキスト形式でエクスポート。ベータ版ではハードウェアを変更しません
A1 Evo/Denon	オプションの別個のブリッジ。このプラグインでは AVR を前提としません

インストール

リリースのダウンロード、絶対ファイルパス、アシスタントの設定については、インストールガイドに従ってください。Codex では config.toml を使用します。リポジトリの .mcp.json は Codex CLI に自動では読み込まれません。ガイドには明示的な登録コマンドが記載されています。

ソースをチェックアウトした場合：

npm ci --ignore-scripts
npm run build
npm test
npm run validate:release

チェックイン済みの MCP 設定は、自己完結型の dist/server.mjs を起動します。パッケージ化された CLI もバンドルされており、公開アーティファクトの実行時 npm 依存関係はゼロです。サードパーティのビルド入力は正確なバージョンに固定し、ライフサイクルスクリプトを無効にしてインストールします。rew_install_discover を実行すると、ユーザーによる上書き、AUDIO_REW_EXECUTABLE 環境変数、PATH、Windows、macOS、Linux の一般的な場所から REW を検出します。検出に失敗した場合は、このツールまたは rew_launch_plan に絶対実行可能ファイルパス（macOS では REW.app）を渡してください。REW を起動するには、一致する rew_launch_execute の確認が必要です。起動は http://127.0.0.1:4735 の API に対して検証されます。AUDIO_REW_URL を上書きするのは、信頼できるローカルネットワークのエンドポイントに接続する場合に限ってください。REW 自体で API を有効にする必要もあります。

ガイド付きワークフロー

初心者向けガイドでは、通常のプロンプトを使い、想定される動作を説明しています。以下の手順は、MCP インターフェースを直接操作したいユーザー向けのツール実行順序です。

1. audio_doctor を実行します。REW がオフラインの場合は、rew_install_discover を使い、その後、確認済みの rew_launch_plan／rew_launch_execute のペアを実行します。続いて、rew_capability_negotiate と audio_guided_session_plan を実行します。
2. ホスト、REW、マイクのキャリブレーション、出力経路、DSP の状態を確認します。
3. 保護機能付きの反復セッション計画を作成します。音を出す操作には、マイクの設置場所、測定エリアの安全確保、出力経路と安全性について、都度確認が必要です。
4. 個別の未処理トレースを保存し、品質、デュアル解像度、直接音／後期音、クロスオーバー、歪み／圧縮、人間の聴感に関する分析を実行します。
5. 設置位置、極性、タイミング、クロスオーバーを優先し、カットを優先する安定した EQ を使います。
6. バックアップとロールバックを備えた、ハッシュに紐付けられた確認済みの計画だけを適用します。
7. 音量を揃えて再測定します。audio_post_eq_verification を開始し、その後 audio_job_status をポーリングします。検証ツールはトレースから音量差を算出します。予測応答や、呼び出し元が音量を揃えたと主張することは、いずれも受け入れ判定の根拠にはなりません。
8. 好みや識別能力を評価するには、ランダム化し、音量を揃えた A/B または ABX テストを行います。JamesDSP では、jamesdsp_ab_plan とプレゼンテーションおよび復元用のエグゼキューターを組み合わせることで、割り当てを明かさずにプリセットとホスト音量をトランザクション方式で切り替えられます。

分析ビュー

レポートには元のトレースを保持し、ネイティブの未平滑化データ、導出したエンジニアリング解像度、1/48 オクターブ構造、モードから知覚特性に適応する平滑化、ERB／知覚ビューを表示します。フィルターの適用対象となるのは、反復測定とホールドアウトデータで特徴が安定している場合に限られます。狭帯域のヌルや空間的なヌルはブーストしません。

audio_report_plan では、反復比較グループを 2～4 個指定することもできます。各状態を平均化し、±1 SD を保持して、測定した音量差を算出し、Markdown、HTML、JSON、および README に適したラベル付きのスタンドアロン SVG を出力します。SNR が欠落している場合、デフォルトでは品質ゲートで不合格になります。探索目的の呼び出し元は、requireSnr: false を明示的に指定してオプトアウトする必要があります。

プライバシー

テレメトリーはありません。ローカルセッションには、ユーザー名、絶対パス、デバイス名、部屋の座標、マイクのハッシュ、プリセットのフィンガープリントが含まれる場合があります。measurements/、sessions/、backups/、profiles/、reports/、filters/ を直接公開しないでください。サポート用のアーティファクトを作成するには、編集機能付きのツールを使用し、共有する前に結果を確認してください。

開発と検証

npm test はハードウェアに依存しません。npm run coverage は、決定論的な DSP と安全性に関するフィクスチャを実行します。npm run validate:release は、マニフェスト、メタデータ、同梱サーバー、パッケージの内容を確認します。実システムでのスモークテストはオプトイン方式であり、通常の CI では決して実行してはなりません。

REW へのリクエストは、デフォルトで同時実行数が 4 件に制限されています。ローカルの REW インスタンスがその同時実行数で検証済みの場合に限り、AUDIO_REW_MAX_CONCURRENCY を 1～8 に設定してください。

SECURITY.md、CONTRIBUTING.md、CHANGELOG.md を参照してください。MIT ライセンスの下でライセンスされています。

測定科学ラボモジュール

制限付きツールでは、GUM 方式の不確かさ予算とモンテカルロ伝播、ブートストラップによる再現性評価、複素伝達関数のコヒーレンスと位相信頼度、ISO-3382 に準拠した室内スクリーニング、探索的な極座標／指向性スキャン、クリーン出力レベルの段階的評価、ホールドアウト席における複数音源の複素最適化、正則化 FIR の提案、制御された聴取試験、イマーシブ／SOFA メタデータの事前検査、参照コーパスの監査を行えます。

Screening、inspired、standards-aligned は、認証済みの適合性を意味するものではありません。ISO、IEC、ANSI/CTA、AES、ITU への適合には、最新の規範文書一式、規定されたセットアップと処理、校正済みの計測機器、追跡可能なエビデンスが必要です。最適化と FIR の出力は、保護された環境で音量を揃えてハードウェアを再測定し、合格するまでは提案にとどまります。

厳選された外部データセット

audio_dataset_catalog は、ダウンロードせずに、厳選された SADIE II、FLAIR、 MeshRIR、RAVes の成果物のレビュー済みメタデータを提供します。データセットの取得には、 ハッシュに紐づけられた計画と実行のペアを使用し、ライセンスへの同意が必要です。また、 バイト数の上限を厳密に適用し、固定された Zenodo HTTPS URL のみを受け付け、上書きを拒否し、 上流のチェックサムを検証して SHA-256 を計算したうえで、ワークスペースの datasets/ ディレクトリに来歴を示すレシートを保存します。

リモートエントリーやチェックサムが検証済みのダウンロードは、自動的に科学的検証を意味するものではありません。 準備状況はドメインごとに算出され、許容誤差の妥当性が示された、解析済みかつ手法に互換性のある参照情報が、 独立した少なくとも 2 つの機関から得られている必要があります。

ノートパソコンのキャリブレーション

ノートパソコンのスピーカーは引き続き完全にサポートされていますが、汎用性が最も低いワークフローであるため、 意図的に最後に説明しています。ノートパソコンモードは、デフォルトで 120 Hz、-30 dBFS から開始します。 予期しない経路、無音、クリッピング、リミッターの動作、異音、または異常が見られた場合は、直ちに停止してください。

プロジェクトを支援する

Audio Calibration MCP は無料のオープンソースです。時間を節約できた場合や、システムの改善に役立った場合は、 daredoole にコーヒーをごちそうできます。