EvoBurrow MCP

Ein sorgfältiger kleiner Kontrollraum für A1 Evo AcoustiX und Denon/Marantz AVRs.

EvoBurrow ist ein inoffizieller, plattformübergreifender Model Context Protocol-Server zum Inspizieren von A1 Evo AcoustiX-Artefakten, zum Betreiben geschützter REW-Workflows, zum Koordinieren von Kalibrierungsvoreinstellungen und zum Durchführen von auf der Whitelist stehenden Denon/Marantz-LAN-Änderungen mit Backups und Verifizierung.

Es ist nicht mit OCA, A1 Evo AcoustiX, Audyssey, Denon oder Marantz verbunden oder von diesen unterstützt. A1 Evo bleibt der Eigentümer von Messung, Optimierung und Kalibrierungsübertragung.

Was im Bau lebt

• Inspizieren und vergleichen Sie .ady, .oca, .avr, .mdat, HTML-Berichte, Zielkurven und Sitzungsprotokolle.

• Diagnostizieren Sie Messwiederholbarkeit, Polarität, Timing, Crossover-Reserven, Subwoofer-Integration und Lautsprechergeometrie.

• Entdecken oder starten Sie REW unter Windows, macOS und Linux, verhandeln Sie seine lokale API, schützen Sie Sweeps, speichern/laden Sie MDAT-Dateien und analysieren Sie phasenbewusste Crossover-Summierung und Multiseat-Konsistenz.

• Lesen Sie den Denon/Marantz-Status, dekodieren Sie Protokollantworten, erstellen Sie einen Schnappschuss des AVR, zeigen Sie genaue Unterschiede an, führen Sie nach Bestätigung nur freigegebene Änderungen aus und verifizieren Sie das Ergebnis.

• Katalogisieren Sie A1-Kalibrierungsdateien und binden Sie deren Hashes an Denon Speaker Preset 1/2, ohne Voreinstellungen mit Quick-Select-Tasten zu verwechseln.

• Führen Sie A1s Terminal-Workflow nur über einen hash-gebundenen, gesperrten, zeitlich begrenzten Adapter mit gespeicherten Transkripten aus.

Generische Auto-, Laptop-, JamesDSP-, FIR-Labor- und Hörtest-Workflows bleiben absichtlich in Audio Calibration MCP.

Related MCP server: room-eq-wizard-mcp

Sicherheitsmodell

Schreibgeschützte Inspektion steht an erster Stelle. Empfänger-Schreibvorgänge, A1-Terminalläufe, Dateiladungen, Zielerstellung und REW-Start verwenden explizite Pläne oder Bestätigung. Beliebige AVR-Protokollzeichenfolgen und undokumentierte Kalibrierungs-Uploads werden nicht bereitgestellt. Backups und Verifizierung nach Änderungen sind Teil des Workflows, nicht optionale Aufräumarbeiten.

EvoBurrow kann eine Kalibrierung nicht „perfekt“ machen, Standards-Konformität zertifizieren oder Hörpräferenz aus einem Diagramm ableiten. Es trennt gemessene Fakten, Berechnungen, technische Interpretation und Community-Berichte.

Anforderungen

• Node.js 20 oder 22

• Ein lokaler A1 Evo AcoustiX-Arbeitsbereich und eine unterstützte ausführbare Datei

• REW mit aktivierter lokaler API auf 127.0.0.1:4735 für Live-Messwerkzeuge

• Ein Denon/Marantz-Empfänger, der im lokalen Netzwerk für AVR-Werkzeuge erreichbar ist

Installation und Ausführung

npm ci
npm run build
npm start

Das Codex-Plugin-Manifest befindet sich in .codex-plugin/plugin.json; .mcp.json startet den gebündelten stdio-Server. A1_EVO_HOME, A1_REW_URL und A1_REW_EXECUTABLE können bei Bedarf die lokale Erkennung überschreiben.

MCP-Konfiguration

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

Der Kompatibilitäts-Serverschlüssel bleibt a1-evo-audio-expert, damit bestehende Clients ihren Tool-Namespace nicht verlieren. Der öffentliche Projekt- und Paketname ist EvoBurrow MCP.

Empfohlener Arbeitsablauf

1. Scannen Sie den Arbeitsbereich und inspizieren Sie die neuesten Artefakte.

2. Testen Sie REW und den AVR, ohne etwas zu ändern.

3. Validieren Sie Messqualität, Lautsprecherfähigkeit, Crossover-Auswahl und Subwoofer-Integration.

4. Lassen Sie A1 die Kalibrierung generieren und übertragen.

5. Erstellen Sie einen Schnappschuss und ordnen Sie die genaue Kalibrierung einem Denon Speaker Preset zu.

6. Führen Sie geschützte Messungen nach der Kalibrierung und einen pegelangepassten Vergleich durch.

7. Bewahren Sie die Basislinie auf und berichten Sie Unsicherheit oder fehlende Beweise klar.

Datenschutz

Es gibt keine Telemetrie. Lokale Artefakte können Empfänger-IP-Adressen, Benutzernamen, absolute Pfade, Raumgeometrie, Mikrofon-Metadaten und Kalibrierungs-Fingerabdrücke enthalten. Veröffentlichen Sie keine Messungen, Backups, Transkripte oder Empfänger-Schnappschüsse, ohne sie zu überprüfen und zu schwärzen.

Entwicklung

npm test baut den Server und führt hardwareunabhängige Tests aus. npm run validate:release prüft Paket-/Plugin-Metadaten und die gebündelte MCP-Oberfläche. Hardware-Smoke-Tests müssen optional bleiben und dürfen niemals in normalen CI ausgeführt werden.

Siehe SECURITY.md, CONTRIBUTING.md und CHANGELOG.md.

Releases werden aus festgelegten GitHub Actions erstellt und getestet. Tag-Workflows erzeugen ein npm-kompatibles Tarball plus eine GitHub-Build-Provenance-Bescheinigung; die npm-Veröffentlichung bleibt ein separater, explizit konfigurierter Schritt.

Unterstützen Sie das Projekt

EvoBurrow ist kostenlos und Open Source. Wenn dieses kleine Häschen Ihre Kalibrierung vor einem schlechten Tag bewahrt, können Sie daredoole einen Kaffee kaufen.