Audio Calibration MCP

Audio Calibration MCP 是一个本地优先、跨平台的 Model Context Protocol 服务器，用于 Room EQ Wizard (REW)。它指导声学测量、扬声器和房间校准、低音炮和分频器分析、保守的 EQ、DSP 部署，以及针对通用、有源扬声器、汽车和笔记本电脑音频系统的实测验证。

本项目不承诺普遍“完美”的声音。REW 可以测量声学系统；但如果没有证据，它无法推断听音者偏好、麦克风摆放位置或扬声器的安全输出能力。该 MCP 会报告缺失的数据，并将偏好与工程计算分开。

兼容性

Related MCP server: music-perception-mcp

安装

下载 GitHub 发布归档，并将 Codex 指向其 .mcp.json。对于源代码检出：

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/ 目录下写入来源收据。

远程条目和校验和验证的下载并不自动构成科学验证。就绪状态按领域计算，需要来自至少两个独立机构的、已解析且方法兼容的参考文献，并具有合理的容差。

笔记本电脑校准

笔记本电脑扬声器仍然完全受支持，但这是最不通用的工作流，并且有意放在最后记录。笔记本电脑模式默认从 120 Hz 和 -30 dBFS 开始。遇到意外的路由、静音、削波、限制器活动、嘎嘎声或异常情况时，立即停止。

支持项目

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