Audio Calibration MCP

Audio Calibration MCP は、Room EQ Wizard (REW) 向けのローカルファースト、クロスプラットフォームの Model Context Protocol サーバーです。音響測定、スピーカーと部屋のキャリブレーション、サブウーファーとクロスオーバー解析、保守的な EQ、DSP 展開、測定による検証を、一般的なオーディオシステム、パワードスピーカー、カーオーディオ、ノートパソコンのオーディオシステム向けにガイドします。

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

互換性

Related MCP server: music-perception-mcp

インストール

GitHub リリースアーカイブをダウンロードし、その .mcp.json を Codex に指定します。ソースチェックアウトの場合:

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

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

ガイド付きワークフロー

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. 一致したレベルで再測定します。予測応答は受け入れの証拠にはなりません。

8. 好み/識別には、ランダム化されたレベル一致の A/B または ABX を使用します。

分析ビュー

レポートはソーストレースを保持し、ネイティブの未平滑化データ、派生エンジニアリング解像度、1/48 オクターブ構造、適応モーダルから知覚への平滑化、および ERB/知覚ビューを表示します。フィルターは、機能が繰り返しと保持データ全体で安定している場合にのみ適格です。狭い/空間的ヌルはブーストされません。

プライバシー

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

開発と検証

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

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 にコーヒーを購入 できます。