Audio Calibration MCP

Audio Calibration MCP — это локальный, кроссплатформенный сервер Model Context Protocol для Room EQ Wizard (REW). Он направляет акустические измерения, калибровку колонок и помещения, анализ сабвуфера и кроссовера, консервативную эквализацию, развёртывание 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, чтобы найти REW через пользовательское переопределение, переменную окружения AUDIO_REW_EXECUTABLE, PATH и стандартные расположения Windows, macOS или Linux. Если обнаружение не удалось, передайте абсолютный путь к исполняемому файлу (или REW.app на macOS) этому инструменту или rew_launch_plan. Запуск REW требует подтверждения через соответствующий rew_launch_execute. Запуск проверяется через API на http://127.0.0.1:4735; переопределяйте AUDIO_REW_URL только для доверенной локальной сетевой конечной точки. API REW всё равно должен быть включён в самом 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. Предпочитайте размещение, полярность, синхронизацию, кроссовер и стабильную эквализацию с приоритетом среза.

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 без их загрузки. Приобретение набора данных использует пару план/выполнение с привязкой к хэшу, требует подтверждения лицензии, обеспечивает точный предел байтов, принимает только закреплённые HTTPS-URL Zenodo, отказывается от перезаписи, проверяет контрольную сумму вышестоящего источника, вычисляет SHA-256 и записывает квитанцию о происхождении в каталог datasets/ рабочей области.

Удалённые записи и загрузки с проверкой контрольной суммы не являются автоматически научной валидацией. Готовность рассчитывается по каждой области и требует разобранных, совместимых с методом ссылок как минимум из двух независимых учреждений с обоснованными допусками.

Калибровка ноутбука

Динамики ноутбуков полностью поддерживаются, но это наименее общий рабочий процесс и намеренно описан последним. Режим ноутбука по умолчанию начинается с 120 Гц и -30 дБFS. Немедленно остановитесь при неожиданном маршруте, тишине, клиппинге, активности лимитера, дребезжании или искажениях.

Поддержка проекта

Audio Calibration MCP — это бесплатный проект с открытым исходным кодом. Если он экономит ваше время или улучшает вашу систему, вы можете купить daredoole кофе.