Audio Calibration MCP

Audio Calibration MCP는 Room EQ Wizard(REW)용 로컬 우선(local-first) 크로스 플랫폼 Model Context Protocol 서버입니다. 일반, 파워드 스피커, 차량, 노트북 오디오 시스템을 위한 음향 측정, 스피커 및 룸 캘리브레이션, 서브우퍼 및 크로스오버 분석, 보수적 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 의존성이 0개임을 선언합니다. 타사 빌드 입력은 정확히 고정(pin)되며 수명 주기 스크립트를 비활성화한 상태로 설치됩니다. rew_install_discover를 실행하여 사용자 재정의, AUDIO_REW_EXECUTABLE 환경 변수, PATH, 그리고 일반적인 Windows, macOS, Linux 위치에서 REW를 찾으세요. 탐색에 실패하면 해당 도구나 rew_launch_plan에 절대 실행 파일 경로(또는 macOS의 경우 REW.app)를 전달하세요. 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/지각 뷰를 표시합니다. 필터는 반복 및 홀드아웃 데이터에서 특성이 안정적인 경우에만 적용 자격이 있습니다. 좁은/공간적 널(null)은 부스트되지 않습니다.

개인정보 보호

텔레메트리가 없습니다. 로컬 세션에는 사용자 이름, 절대 경로, 장치 이름, 룸 좌표, 마이크 해시, 프리셋 지문이 포함될 수 있습니다. 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 스타일 불확도 예산 및 Monte Carlo 전파, 부트스트랩 반복성, 복소 전달 일관성 및 위상 신뢰도, 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/ 디렉터리 아래에 출처 영수증을 작성합니다.

원격 항목과 체크섬 검증된 다운로드는 자동으로 과학적 검증이 아닙니다. 준비 상태는 도메인별로 계산되며, 정당한 허용 오차를 가진 최소 두 개의 독립 기관에서 파싱된 방법 호환 참조가 필요합니다.

노트북 캘리브레이션

노트북 스피커는 완전히 지원되지만, 이는 가장 덜 일반적인 워크플로이며 의도적으로 마지막에 문서화되었습니다. 노트북 모드는 기본적으로 120Hz 및 -30dBFS에서 시작합니다. 예상치 못한 경로, 무음, 클리핑, 리미터 활동, 덜거덕거림 또는 이상 징후가 발생하면 즉시 중지하세요.

프로젝트 지원

Audio Calibration MCP는 무료 오픈 소스입니다. 시간을 절약하거나 시스템을 개선하는 데 도움이 되었다면 daredoole에게 커피를 사줄 수 있습니다.