Audio Calibration MCP

Audio Calibration MCP

Audio Calibration MCP 是一款面向 Room EQ Wizard（REW）的本地优先、跨平台 Model Context Protocol 服务。它可指导声学测量、扬声器和房间校准、低音炮和分频分析、保守均衡、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 声学测量和基于证据的均衡	检查 A1 Evo AcoustiX 工件或使用终端工作流
房间、扬声器、低音炮、汽车、有源扬声器或笔记本电脑校准	Denon/Marantz AVR 状态、预设映射、备份或受保护的局域网控制
JamesDSP、CamillaDSP、Equalizer APO、FIR 或听音测试工作流	结合实时接收器状态审查 Audyssey .ady/.oca 文件

两个项目都遵循测量规范，但本 MCP 有意保持硬件中立；A1 和 AVR 专属的安全边界由 EvoBurrow 负责。

实测笔记本示例——前后对比

这些是通过每种状态下重复进行 4 次 REW 扫频并取平均得到的实测数据，采用 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 兼容的文本导出；Beta 版本不会修改硬件
A1 Evo/Denon	可选的独立桥接；此插件不对 AV 接收机做任何假设

安装

请按照安装指南下载发行版、了解绝对文件路径，并配置助手。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。如果发现失败，请将绝对可执行文件路径（或 macOS 上的 REW.app）传递给该工具或 rew_launch_plan。启动 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 也可接受两到四组重复对比数据。它会对每种状态求平均，保留 ±1 SD，计算实测电平差，并导出 Markdown、HTML、JSON，以及适合放入 README 的独立带标签 SVG。缺少 SNR 时，默认质量门禁不通过；探索性调用方必须显式设置 requireSnr: false 才能选择不要求 SNR。

隐私

本项目不收集遥测数据。本地会话可能包含用户名、绝对路径、设备名称、房间坐标、麦克风哈希和预设指纹。切勿直接发布 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 License 授权。

测量科学实验室模块

受限工具涵盖 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/ 目录下写入来源凭据。

远程条目和通过校验和验证的下载并不等同于科学验证。就绪状态按领域计算，要求至少有两个独立机构提供经过解析且方法兼容的参考数据，并且容差有充分依据。

笔记本电脑校准

笔记本电脑扬声器仍受全面支持，但这是适用范围最窄的工作流，因此有意放在最后说明。笔记本电脑模式默认从 120 Hz 和 -30 dBFS 开始。如果出现意外的音频路由、静音、削波、限幅器活动、异响或设备异常，请立即停止。

支持项目

Audio Calibration MCP 免费且开源。如果它为你节省了时间或改善了你的系统，你可以请 daredoole 喝杯咖啡。