EvoBurrow MCP

EvoBurrow MCP

A1 Evo AcoustiX と Denon／Marantz AVR 向けの、慎重な小さなコントロールルームです。

EvoBurrow は、A1 Evo AcoustiX、Room EQ Wizard（REW）、Audyssey のキャリブレーション関連ファイル、および Denon／Marantz AVR の制御に対応する、非公式のクロスプラットフォーム Model Context Protocol（MCP）サーバーです。キャリブレーションファイルを検査し、保護された測定を実行し、Speaker Preset 1/2 を連携させ、バックアップと検証を伴う許可リスト方式の LAN 変更を行います。

OCA、A1 Evo AcoustiX、Audyssey、Denon、Marantz とは提携関係になく、これらからの承認も受けていません。測定、最適化、キャリブレーションの転送は、引き続き A1 Evo が担います。

用途に合ったオーディオ MCP を選ぶ

次の用途にはこのプロジェクトをお使いください	次の用途には Audio Calibration MCP をお使いください
A1 Evo AcoustiX の関連ファイルの検査やターミナルでのワークフロー	REW による汎用的な測定や、ルーム／スピーカーの分析
Denon／Marantz AVR の状態確認、プリセットの対応付け、バックアップ、または保護された LAN 制御	カーオーディオ、パワードスピーカー、ノート PC のオーディオ、または単体 DSP
ライブ AVR の状態にひも付けた Audyssey .ady／.oca キャリブレーションの確認	JamesDSP、CamillaDSP、Equalizer APO、FIR、またはリスニングテストのワークフロー

両プロジェクトは相互に補完し合いますが、意図的に分けられています。EvoBurrow は AVR 固有の安全対策と A1 のコンテキストを担い、Audio Calibration MCP はハードウェアに依存しない設計を維持します。

burrow の機能

• .ady、.oca、.avr、.mdat、HTML レポート、ターゲットカーブ、セッションログを検査して比較します。
• 測定の再現性、極性、タイミング、クロスオーバーのヘッドルーム、サブウーファーの統合、スピーカーの配置を診断します。
• Windows、macOS、Linux で REW を検出または起動し、ローカル API をネゴシエートし、スイープを保護し、MDAT ファイルを保存／読み込みし、位相を考慮したクロスオーバーの合算とマルチシートの一貫性を分析します。
• Denon／Marantz の状態を読み取り、プロトコルの応答をデコードし、AVR のスナップショットを作成し、正確な差分を事前表示して、確認後に許可リストにある変更のみを実行し、結果を検証します。
• A1 のキャリブレーションファイルをカタログ化し、プリセットと Quick Select ボタンを混同することなく、ハッシュを Denon Speaker Preset 1/2 にひも付けます。
• 保存済みのトランスクリプトを備えた、ハッシュにひも付けられ、ロックされ、実行時間が制限されたアダプターを通じてのみ、A1 のターミナルワークフローを実行します。

汎用的なカーオーディオ、ノート PC、JamesDSP、FIR ラボ、リスニングテストのワークフローは、意図的に Audio Calibration MCP に残しています。

安全性モデル

まず読み取り専用の検査を行います。レシーバーへの書き込み、A1 のターミナル実行、ファイルの読み込み、ターゲットの作成、REW の起動には、明示的な計画または確認が必要です。任意の AVR プロトコル文字列や、ドキュメント化されていないキャリブレーションのアップロード機能は公開していません。バックアップと変更後の検証は、任意の後処理ではなくワークフローの一部です。

EvoBurrow は、キャリブレーションを「完璧」にしたり、規格への準拠を証明したり、グラフからリスニングの好みを導き出したりすることはできません。測定事実、計算、工学的な解釈、コミュニティからの報告を区別します。

要件

• Node.js 20 または 22
• ローカルの A1 Evo AcoustiX ワークスペースと、対応する実行可能ファイル
• ライブ測定ツールを使う場合、ローカル API を有効にした REW（127.0.0.1:4735）
• AVR ツールを使う場合、ローカルネットワーク上で接続可能な Denon／Marantz レシーバー

インストールと実行

npm ci
npm run build
npm start

Codex プラグインのマニフェストは .codex-plugin/plugin.json にあり、.mcp.json は同梱の stdio サーバーを起動します。必要に応じて、A1_EVO_HOME、A1_REW_URL、A1_REW_EXECUTABLE でローカルの検出先を上書きできます。

MCP の設定

{
  "mcpServers": {
    "a1-evo-audio-expert": {
      "command": "node",
      "args": ["/absolute/path/to/evoburrow-mcp/dist/server.mjs"]
    }
  }
}

互換性サーバーのキーは a1-evo-audio-expert のままにするため、既存のクライアントがツールの名前空間を失うことはありません。公開プロジェクト名およびパッケージ名は EvoBurrow MCP です。

推奨ワークフロー

1. ワークスペースをスキャンし、最新の成果物を確認します。
2. 何も変更せずに REW と AVR を調査します。
3. 測定品質、スピーカーの性能、クロスオーバーの選択、サブウーファーの統合を検証します。
4. A1 にキャリブレーションを生成させ、転送します。
5. キャリブレーションの正確な内容をスナップショットに保存し、Denon Speaker Preset に対応付けます。
6. 保護されたキャリブレーション後の測定と、音量を揃えた比較を実施します。
7. ベースラインを保持し、不確実性や不足している証拠を明確に報告します。

プライバシー

テレメトリーはありません。ローカルの成果物には、レシーバーの IP アドレス、ユーザー名、絶対パス、部屋の形状、マイクのメタデータ、キャリブレーションのフィンガープリントが含まれる場合があります。測定結果、バックアップ、トランスクリプト、レシーバーのスナップショットを公開する前に、内容を確認して機密情報を伏せてください。

開発

npm test はサーバーをビルドし、ハードウェアに依存しないテストを実行します。npm run validate:release は、パッケージとプラグインのメタデータ、およびバンドルされた MCP のインターフェースを検証します。ハードウェアのスモークテストは明示的に有効化した場合のみ実行し、通常の CI では決して実行しないでください。

SECURITY.md、CONTRIBUTING.md、CHANGELOG.md を参照してください。

リリースは、バージョンを固定した GitHub Actions でビルドおよびテストされます。タグのワークフローでは、npm 互換の tarball と GitHub のビルド来歴のアテステーションが生成されます。npm への公開は、別途明示的に設定する手順として残されています。

プロジェクトを支援する

EvoBurrow は無料のオープンソースです。この小さなウサギがキャリブレーションの失敗を防いでくれたら、daredoole にコーヒーをおごることができます。