Audio Calibration MCP

Audio Calibration MCP es un servidor del Model Context Protocol local-first y multiplataforma para Room EQ Wizard (REW). Guía la medición acústica, la calibración de altavoces y sala, el análisis de subwoofers y cruces, EQ conservador, despliegue de DSP y verificación medida para sistemas de audio generales, de altavoces amplificados, de automóvil y de portátiles.

Este proyecto no promete un sonido universalmente “perfecto”. REW puede medir un sistema acústico; no puede inferir la preferencia del oyente, la colocación del micrófono o la capacidad de salida segura de un altavoz sin evidencia. El MCP informa de los datos faltantes y mantiene la preferencia separada de los cálculos de ingeniería.

Compatibilidad

Related MCP server: music-perception-mcp

Instalación

Descarga un archivo de lanzamiento de GitHub y apunta Codex a su .mcp.json. Para una copia del código fuente:

npm ci --ignore-scripts
npm test
npm run validate:release

La configuración MCP incluida inicia el dist/server.mjs autocontenido. El CLI empaquetado también está incluido, y el artefacto publicado declara cero dependencias npm en tiempo de ejecución. Las entradas de compilación de terceros están fijadas exactamente e instaladas con los scripts de ciclo de vida deshabilitados. Ejecuta rew_install_discover para localizar REW a través de una anulación de usuario, la variable de entorno AUDIO_REW_EXECUTABLE, PATH y ubicaciones convencionales de Windows, macOS o Linux. Si el descubrimiento falla, pasa la ruta absoluta del ejecutable (o REW.app en macOS) a esa herramienta o a rew_launch_plan. Iniciar REW requiere la confirmación correspondiente de rew_launch_execute. El arranque se verifica contra la API en http://127.0.0.1:4735; anula AUDIO_REW_URL solo para un endpoint de red local de confianza. La API de REW aún debe estar habilitada en el propio REW.

Flujo de trabajo guiado

1. Ejecuta audio_doctor. Si REW está fuera de línea, usa rew_install_discover y luego el par confirmado rew_launch_plan/rew_launch_execute. Continúa con rew_capability_negotiate y audio_guided_session_plan.

2. Inventaría el host, REW, la calibración del micrófono, la ruta de salida y el estado del DSP.

3. Crea un plan de sesión repetida protegido. La ejecución audible requiere confirmación fresca de colocación del micrófono, área despejada y ruta/seguridad.

4. Guarda trazas crudas separadas y luego ejecuta análisis de calidad, doble resolución, directo/tardío, cruce, distorsión/compresión y escucha humana.

5. Prefiere colocación, polaridad, temporización, cruce y EQ estable de corte primero.

6. Aplica solo un plan confirmado vinculado a hash con copia de seguridad y reversión.

7. Vuelve a medir con nivel coincidente. La respuesta predicha nunca es evidencia de aceptación.

8. Usa A/B o ABX aleatorizado y con nivel coincidente para preferencia/discriminación.

Vistas de análisis

Los informes conservan la traza fuente y muestran datos nativos sin suavizar, resolución de ingeniería derivada, estructura de 1/48 de octava, suavizado adaptativo modal a perceptual y vistas ERB/perceptuales. Los filtros son elegibles solo cuando las características son estables entre repeticiones y datos reservados. Los nulos estrechos/espaciales no se amplifican.

Privacidad

No hay telemetría. Las sesiones locales pueden contener nombres de usuario, rutas absolutas, nombres de dispositivos, coordenadas de sala, hashes de micrófono y huellas de preajustes. Nunca publiques measurements/, sessions/, backups/, profiles/, reports/ o filters/ directamente. Usa las herramientas de artefactos de soporte redactados y revisa el resultado antes de compartirlo.

Desarrollo y validación

npm test es independiente del hardware. npm run coverage ejercita accesorios deterministas de DSP y seguridad. npm run validate:release verifica manifiestos, metadatos, el servidor empaquetado y el contenido del paquete. Las pruebas de humo de sistemas reales son opcionales y nunca deben ejecutarse en CI ordinario.

Consulta SECURITY.md, CONTRIBUTING.md y CHANGELOG.md. Licenciado bajo la Licencia MIT.

Módulos de laboratorio de ciencia de medición

Las herramientas acotadas cubren presupuestos de incertidumbre estilo GUM y propagación de Monte Carlo, repetibilidad bootstrap, coherencia de transferencia compleja y confianza de fase, detección de sala alineada con ISO-3382, exploraciones polares/directividad exploratorias, escaleras de salida limpia, optimización compleja de múltiples fuentes en asientos reservados, propuestas FIR regularizadas, ensayos de escucha controlados, preflight de metadatos inmersivos/SOFA y auditoría de corpus de referencia.

Screening, inspired y standards-aligned nunca significan conformidad certificada. La conformidad con ISO, IEC, ANSI/CTA, AES e ITU requiere el documento normativo completo actual, configuración y procesamiento prescritos, instrumentación calibrada y evidencia trazable. Las salidas de optimización y FIR siguen siendo propuestas hasta que una remedición de hardware protegida y con nivel coincidente las acepte.

Conjuntos de datos externos seleccionados

audio_dataset_catalog expone metadatos revisados para artefactos seleccionados de SADIE II, FLAIR, MeshRIR y RAVes sin descargarlos. La adquisición de conjuntos de datos utiliza un par plan/ejecución vinculado a hash, requiere reconocimiento de licencia, impone un límite de bytes exacto, acepta solo URL HTTPS de Zenodo fijadas, rechaza sobrescrituras, verifica la suma de comprobación ascendente, calcula SHA-256 y escribe un recibo de procedencia en el directorio datasets/ del espacio de trabajo.

Las entradas remotas y las descargas verificadas por suma de comprobación no son automáticamente validación científica. La preparación se calcula por dominio y requiere referencias analizadas y compatibles con el método de al menos dos instituciones independientes con tolerancias justificadas.

Calibración de portátiles

Los altavoces de portátiles siguen siendo totalmente compatibles, pero este es el flujo de trabajo menos general y se documenta intencionalmente al final. El modo portátil comienza a 120 Hz y -30 dBFS por defecto. Detente inmediatamente ante una ruta inesperada, silencio, recorte, actividad del limitador, traqueteo o angustia.

Apoya el proyecto

Audio Calibration MCP es gratuito y de código abierto. Si te ahorra tiempo o mejora tu sistema, puedes invitar a daredoole a un café.