EvoBurrow MCP

EvoBurrow MCP

面向 A1 Evo AcoustiX 和 Denon/Marantz AVR 的精心设计的小型控制室。

EvoBurrow 是一款非官方、跨平台的 Model Context Protocol (MCP) 服务，适用于 A1 Evo AcoustiX、Room EQ Wizard (REW)、Audyssey 校准文件和 Denon/Marantz AVR 控制。它可以检查校准文件、运行受保护的测量、协调 Speaker Preset 1/2，并通过备份和验证执行允许列表中的局域网更改。

它与 OCA、A1 Evo AcoustiX、Audyssey、Denon 或 Marantz 均无关联，也未获其认可。测量、优化和校准传输仍由 A1 Evo 负责。

选择合适的音频 MCP

在以下情况下使用此项目	在以下情况下使用 Audio Calibration MCP
需要检查 A1 Evo AcoustiX 文件或运行终端工作流	需要通用 REW 测量及房间／扬声器分析
需要查看 Denon/Marantz AVR 状态、预设映射、备份或受保护的局域网控制	需要处理汽车音响、有源扬声器、笔记本电脑音频或独立 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 校准文件，并将其哈希值绑定到 Denon Speaker Preset 1/2，避免将预设与 Quick Select 按钮混淆。
• 仅通过带哈希绑定、加锁且有时限的适配器运行 A1 终端工作流，并保存执行记录。

通用汽车音响、笔记本电脑、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 喝杯咖啡。