Audio Calibration MCP

Audio Calibration MCP ist ein lokaler, plattformübergreifender Model Context Protocol Server für Room EQ Wizard (REW). Er leitet akustische Messungen, Lautsprecher- und Raumkalibrierung, Subwoofer- und Frequenzweichenanalyse, konservative Entzerrung, DSP-Bereitstellung und messbasierte Verifikation für allgemeine, Aktivlautsprecher-, Auto- und Laptop-Audiosysteme an.

Dieses Projekt verspricht keinen universell „perfekten“ Klang. REW kann ein akustisches System messen; es kann jedoch nicht auf Hörerpräferenz, Mikrofonplatzierung oder die sichere Ausgangsleistung eines Lautsprechers ohne Belege schließen. Der MCP meldet fehlende Daten und hält Präferenz von technischen Berechnungen getrennt.

Kompatibilität

Related MCP server: music-perception-mcp

Installation

Laden Sie ein GitHub-Release-Archiv herunter und weisen Sie Codex auf dessen .mcp.json an. Für einen Quellcode-Checkout:

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

Die eingecheckte MCP-Konfiguration startet das eigenständige dist/server.mjs. Das gepackte CLI ist ebenfalls enthalten, und das veröffentlichte Artefakt deklariert null Laufzeit-npm-Abhängigkeiten. Build-Eingaben von Drittanbietern sind exakt gepinnt und werden mit deaktivierten Lebenszyklus-Skripten installiert. Führen Sie rew_install_discover aus, um REW über eine Benutzerüberschreibung, die Umgebungsvariable AUDIO_REW_EXECUTABLE, PATH und übliche Windows-, macOS- oder Linux-Speicherorte zu finden. Wenn die Erkennung fehlschlägt, übergeben Sie den absoluten Pfad der ausführbaren Datei (oder REW.app unter macOS) an dieses Tool oder an rew_launch_plan. Das Starten von REW erfordert die passende Bestätigung von rew_launch_execute. Der Start wird gegen die API unter http://127.0.0.1:4735 verifiziert; überschreiben Sie AUDIO_REW_URL nur für einen vertrauenswürdigen lokalen Netzwerkendpunkt. Die REW-API muss in REW selbst weiterhin aktiviert sein.

Geführter Arbeitsablauf

1. Führen Sie audio_doctor aus. Wenn REW offline ist, verwenden Sie rew_install_discover und dann das bestätigte Paar rew_launch_plan/rew_launch_execute. Fahren Sie mit rew_capability_negotiate und audio_guided_session_plan fort.

2. Erfassen Sie den Host, REW, Mikrofonkalibrierung, Ausgaberoute und DSP-Zustand.

3. Erstellen Sie einen geschützten Plan für wiederholte Sitzungen. Für hörbare Ausführung sind frische Bestätigungen zu Mikrofonplatzierung, freiem Bereich und Route/Sicherheit erforderlich.

4. Speichern Sie separate Rohmessungen und führen Sie dann Qualitäts-, Dual-Auflösungs-, Direkt/Spät-, Frequenzweichen-, Verzerrungs/Kompressions- und Hör-Analysen durch.

5. Bevorzugen Sie Platzierung, Polarität, Timing, Frequenzweiche und stabile, zuerst geschnittene Entzerrung.

6. Wenden Sie nur einen hash-gebundenen, bestätigten Plan mit Backup und Rollback an.

7. Messen Sie erneut bei angepasstem Pegel. Die vorhergesagte Antwort ist niemals ein Akzeptanznachweis.

8. Verwenden Sie randomisierte, pegelangepasste A/B- oder ABX-Tests für Präferenz/Diskriminierung.

Analyseansichten

Berichte bewahren die Quellmessung und zeigen native ungeglättete Daten, abgeleitete technische Auflösung, 1/48-Oktav-Struktur, adaptive modale bis wahrnehmungsbezogene Glättung sowie ERB/wahrnehmungsbezogene Ansichten. Filter sind nur zulässig, wenn Merkmale über Wiederholungen und zurückgehaltene Daten stabil sind. Schmale/räumliche Nullstellen werden nicht angehoben.

Datenschutz

Es gibt keine Telemetrie. Lokale Sitzungen können Benutzernamen, absolute Pfade, Gerätenamen, Raumkoordinaten, Mikrofon-Hashes und Preset-Fingerabdrücke enthalten. Veröffentlichen Sie niemals measurements/, sessions/, backups/, profiles/, reports/ oder filters/ direkt. Verwenden Sie die redigierten Support-Artefakt-Tools und überprüfen Sie das Ergebnis, bevor Sie es teilen.

Entwicklung und Validierung

npm test ist hardwareunabhängig. npm run coverage testet deterministische DSP- und Sicherheits-Fixtures. npm run validate:release prüft Manifeste, Metadaten, den gebündelten Server und Paketinhalte. Smoke-Tests auf echten Systemen sind optional und dürfen niemals in normalen CI ausgeführt werden.

Siehe SECURITY.md, CONTRIBUTING.md und CHANGELOG.md. Lizenziert unter der MIT-Lizenz.

Messwissenschaftliche Labormodule

Begrenzte Werkzeuge decken GUM-artige Unsicherheitsbudgets und Monte-Carlo-Propagation, Bootstrap-Wiederholbarkeit, Kohärenz und Phasenkonfidenz bei komplexer Übertragung, ISO-3382-konformes Raum-Screening, explorative Polar-/Richtcharakteristik-Scans, saubere Ausgangsleitern, komplexe Mehrquellen-Optimierung für zurückgehaltene Sitzplätze, regularisierte FIR-Vorschläge, kontrollierte Hörversuche, immersive/SOFA-Metadaten-Preflight und Referenzkorpus-Auditierung ab.

Screening, inspiriert und standardskonform bedeuten niemals zertifizierte Konformität. ISO-, IEC-, ANSI/CTA-, AES- und ITU-Konformität erfordert das vollständige aktuelle normative Dokument, vorgeschriebene Einrichtung und Verarbeitung, kalibrierte Instrumentierung und nachvollziehbare Belege. Optimierungs- und FIR-Ausgaben bleiben Vorschläge, bis eine geschützte, pegelangepasste Hardware-Neumessung sie akzeptiert.

Kuratierte externe Datensätze

audio_dataset_catalog stellt überprüfte Metadaten für ausgewählte SADIE II-, FLAIR-, MeshRIR- und RAVes-Artefakte bereit, ohne sie herunterzuladen. Die Datensatzbeschaffung verwendet ein hash-gebundenes Plan/Ausführungs-Paar, erfordert Lizenzbestätigung, erzwingt eine exakte Byte-Obergrenze, akzeptiert nur gepinnte Zenodo-HTTPS-URLs, verweigert Überschreibungen, prüft die Upstream-Prüfsumme, berechnet SHA-256 und schreibt eine Herkunftsquittung unter das Arbeitsbereichsverzeichnis datasets/.

Remote-Einträge und prüfsummenverifizierte Downloads sind nicht automatisch wissenschaftliche Validierung. Die Bereitschaft wird pro Domäne berechnet und erfordert geparste, methodenkompatible Referenzen von mindestens zwei unabhängigen Institutionen mit begründeten Toleranzen.

Laptop-Kalibrierung

Laptop-Lautsprecher werden weiterhin vollständig unterstützt, aber dies ist der am wenigsten allgemeine Arbeitsablauf und wird absichtlich zuletzt dokumentiert. Der Laptop-Modus startet standardmäßig bei 120 Hz und -30 dBFS. Stoppen Sie sofort bei unerwarteter Route, Stille, Clipping, Limiter-Aktivität, Rasseln oder Notlage.

Unterstützen Sie das Projekt

Audio Calibration MCP ist kostenlos und Open Source. Wenn es Ihnen Zeit spart oder Ihr System verbessert, können Sie daredoole einen Kaffee kaufen.