EvoBurrow MCP

A1 Evo AcoustiX 및 Denon/Marantz AVR을 위한 세심한 제어실.

EvoBurrow는 A1 Evo AcoustiX 아티팩트 검사, 보호된 REW 워크플로우 운영, 캘리브레이션 프리셋 조정, 그리고 백업 및 검증을 포함한 허용 목록 기반 Denon/Marantz LAN 변경을 위한 비공식 크로스 플랫폼 Model Context Protocol 서버입니다.

이 프로젝트는 OCA, A1 Evo AcoustiX, Audyssey, Denon 또는 Marantz와 제휴하거나 보증하지 않습니다. 측정, 최적화 및 캘리브레이션 전송의 소유권은 A1 Evo에 있습니다.

굴 속에 있는 것들

• .ady, .oca, .avr, .mdat, HTML 리포트, 타겟 커브 및 세션 로그를 검사하고 비교합니다.

• 측정 반복성, 극성, 타이밍, 크로스오버 헤드룸, 서브우퍼 통합 및 스피커 지오메트리를 진단합니다.

• Windows, macOS, Linux에서 REW를 탐색하거나 시작하고, 로컬 API를 협상하며, 스윕을 보호하고, MDAT 파일을 저장/로드하며, 위상 인지 크로스오버 합산 및 다중 좌석 일관성을 분석합니다.

• Denon/Marantz 상태를 읽고, 프로토콜 응답을 디코딩하며, AVR 스냅샷을 생성하고, 정확한 차이점을 미리 보고, 확인 후 허용 목록에 있는 변경만 실행하고 결과를 검증합니다.

• A1 캘리브레이션 파일을 카탈로그화하고 해당 해시를 Denon Speaker Preset 1/2에 바인딩하여 프리셋과 Quick Select 버튼을 혼동하지 않도록 합니다.

• A1의 터미널 워크플로우를 해시 바인딩, 잠금, 시간 제한 어댑터를 통해서만 실행하고 트랜스크립트를 저장합니다.

일반 자동차, 노트북, JamesDSP, FIR-laboratory 및 청취 테스트 워크플로우는 의도적으로 Audio Calibration MCP에 남아 있습니다.

Related MCP server: room-eq-wizard-mcp

안전 모델

읽기 전용 검사가 우선입니다. 리시버 쓰기, A1 터미널 실행, 파일 로드, 타겟 생성 및 REW 시작은 명시적인 계획 또는 확인을 사용합니다. 임의의 AVR 프로토콜 문자열과 문서화되지 않은 캘리브레이션 업로드는 노출되지 않습니다. 백업 및 변경 후 검증은 선택적 정리가 아닌 워크플로우의 일부입니다.

EvoBurrow는 캘리브레이션을 "완벽하게" 만들거나, 표준 준수를 인증하거나, 그래프에서 청취 선호도를 도출할 수 없습니다. 측정된 사실, 계산, 엔지니어링 해석 및 커뮤니티 보고서를 분리합니다.

요구 사항

• Node.js 20 또는 22

• 로컬 A1 Evo AcoustiX 워크스페이스 및 지원되는 실행 파일

• 실시간 측정 도구를 위해 로컬 API가 127.0.0.1:4735에서 활성화된 REW

• AVR 도구를 위해 로컬 네트워크에서 접근 가능한 Denon/Marantz 리시버

설치 및 실행

npm ci
npm run build
npm start

Codex 플러그인 매니페스트는 .codex-plugin/plugin.json에 있습니다. .mcp.json은 번들된 stdio 서버를 실행합니다. A1_EVO_HOME, A1_REW_URL 및 A1_REW_EXECUTABLE은 필요할 때 로컬 탐색을 재정의할 수 있습니다.

MCP 구성

{
  "mcpServers": {
    "a1-evo-audio-expert": {
      "command": "node",
      "args": ["/absolute/path/to/evoburrow-mcp/dist/server.mjs"]
    }
  }
}

호환성 서버 키는 기존 클라이언트가 도구 네임스페이스를 잃지 않도록 a1-evo-audio-expert로 유지됩니다. 공개 프로젝트 및 패키지 이름은 EvoBurrow MCP입니다.

권장 워크플로우

1. 워크스페이스를 스캔하고 최신 아티팩트를 검사합니다.

2. 아무것도 변경하지 않고 REW와 AVR을 프로브합니다.

3. 측정 품질, 스피커 성능, 크로스오버 선택 및 서브우퍼 통합을 검증합니다.

4. A1이 캘리브레이션을 생성하고 전송하도록 합니다.

5. 정확한 캘리브레이션을 Denon Speaker Preset에 스냅샷하고 매핑합니다.

6. 보호된 캘리브레이션 후 측정과 레벨 매칭 비교를 실행합니다.

7. 기준선을 보존하고 불확실성 또는 누락된 증거를 명확하게 보고합니다.

개인정보 보호

텔레메트리가 없습니다. 로컬 아티팩트에는 리시버 IP 주소, 사용자 이름, 절대 경로, 실내 지오메트리, 마이크 메타데이터 및 캘리브레이션 지문이 포함될 수 있습니다. 검토 및 편집 없이 측정값, 백업, 트랜스크립트 또는 리시버 스냅샷을 게시하지 마십시오.

개발

npm test는 서버를 빌드하고 하드웨어 독립적인 테스트를 실행합니다. npm run validate:release는 패키지/플러그인 메타데이터와 번들된 MCP 표면을 확인합니다. 하드웨어 스모크 테스트는 옵트인 상태를 유지해야 하며 일반 CI에서 절대 실행되어서는 안 됩니다.

SECURITY.md, CONTRIBUTING.md 및 CHANGELOG.md를 참조하십시오.

릴리스는 고정된 GitHub Actions에서 빌드 및 테스트됩니다. 태그 워크플로우는 npm 호환 tarball과 GitHub 빌드 출처 증명(attestation)을 생성합니다. npm 게시는 별도의 명시적으로 구성된 단계로 유지됩니다.

프로젝트 지원

EvoBurrow는 무료 오픈 소스입니다. 이 작은 토끼가 캘리브레이션을 위기에서 구해준다면, daredoole에게 커피를 사줄 수 있습니다.