EvoBurrow MCP

一个为 A1 Evo AcoustiX 和 Denon/Marantz AVR 打造的细心小控制室。

EvoBurrow 是一个非官方的跨平台 Model Context Protocol 服务器，用于检查 A1 Evo AcoustiX 工件、操作受保护的 REW 工作流、协调校准预设，以及通过备份和验证对 Denon/Marantz LAN 进行白名单更改。

它与 OCA、A1 Evo AcoustiX、Audyssey、Denon 或 Marantz 无关联，也未获得其认可。A1 Evo 仍然是测量、优化和校准传输的所有者。

洞穴里有什么

• 检查和比较 .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 中。

Related MCP server: room-eq-wizard-mcp

安全模型

只读检查优先。接收器写入、A1 终端运行、文件加载、目标创建和 REW 启动均需明确的计划或确认。不暴露任意的 AVR 协议字符串和未记录的校准上传。备份和变更后验证是工作流的一部分，而非可选的清理步骤。

EvoBurrow 无法让校准变得"完美"、认证标准合规性，或从图表中推导出听音偏好。它将测量事实、计算、工程解释和社区报告区分开来。

要求

• Node.js 20 或 22

• 本地 A1 Evo AcoustiX 工作区和受支持的可执行文件

• 在 127.0.0.1:4735 上启用本地 API 的 REW，用于实时测量工具

• 本地网络上可访问的 Denon/Marantz 接收器，用于 AVR 工具

安装与运行

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 喝杯咖啡。