EvoBurrow MCP

Аккуратная маленькая контрольная комната для A1 Evo AcoustiX и ресиверов Denon/Marantz.

EvoBurrow — это неофициальный кроссплатформенный сервер Model Context Protocol для проверки артефактов A1 Evo AcoustiX, выполнения защищённых рабочих процессов REW, координации калибровочных пресетов и внесения разрешённых изменений в Denon/Marantz по локальной сети с резервным копированием и проверкой.

Он не связан с OCA, A1 Evo AcoustiX, Audyssey, Denon или Marantz и не одобрен ими. A1 Evo остаётся владельцем измерений, оптимизации и передачи калибровки.

Что живёт в норе

• Просматривайте и сравнивайте .ady, .oca, .avr, .mdat, HTML-отчёты, целевые кривые и журналы сеансов.

• Диагностируйте повторяемость измерений, полярность, синхронизацию, запас по кроссоверу, интеграцию сабвуфера и геометрию колонок.

• Обнаруживайте или запускайте REW на Windows, macOS и Linux, согласуйте его локальный API, защищайте свип-сигналы, сохраняйте/загружайте файлы MDAT и анализируйте суммирование кроссовера с учётом фазы и согласованность нескольких мест прослушивания.

• Читайте статус Denon/Marantz, декодируйте ответы протокола, делайте снимок AVR, просматривайте точные различия, выполняйте только разрешённые изменения после подтверждения и проверяйте результат.

• Каталогизируйте файлы калибровки A1 и привязывайте их хэши к пресетам колонок Denon 1/2, не путая пресеты с кнопками Quick Select.

• Запускайте терминальный рабочий процесс A1 только через адаптер, привязанный к хэшу, заблокированный и ограниченный по времени, с сохранением транскриптов.

Общие рабочие процессы для автомобиля, ноутбука, JamesDSP, FIR-лаборатории и прослушивания намеренно остаются в Audio Calibration MCP.

Related MCP server: room-eq-wizard-mcp

Модель безопасности

Сначала идёт проверка только для чтения. Запись в ресивер, запуск терминала A1, загрузка файлов, создание целевых кривых и запуск REW требуют явных планов или подтверждения. Произвольные строки протокола AVR и недокументированные загрузки калибровок не предоставляются. Резервное копирование и проверка после изменений — часть рабочего процесса, а не необязательная уборка.

EvoBurrow не может сделать калибровку «идеальной», подтвердить соответствие стандартам или вывести предпочтения прослушивания из графика. Он разделяет измеренные факты, расчёты, инженерную интерпретацию и сообщения сообщества.

Требования

• Node.js 20 или 22

• Локальное рабочее пространство A1 Evo AcoustiX и поддерживаемый исполняемый файл

• REW с включённым локальным API на 127.0.0.1:4735 для инструментов живых измерений

• Ресивер Denon/Marantz, доступный в локальной сети, для инструментов AVR

Установка и запуск

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.

6. Выполните защищённые измерения после калибровки и сравнение с выровненным уровнем.

7. Сохраните базовую линию и чётко сообщите о неопределённости или отсутствующих доказательствах.

Конфиденциальность

Телеметрии нет. Локальные артефакты могут содержать IP-адреса ресиверов, имена пользователей, абсолютные пути, геометрию помещения, метаданные микрофона и отпечатки калибровки. Не публикуйте измерения, резервные копии, транскрипты или снимки ресивера без проверки и редактирования.

Разработка

npm test собирает сервер и запускает аппаратно-независимые тесты. npm run validate:release проверяет метаданные пакета/плагина и встроенную поверхность MCP. Аппаратные смоук-тесты должны оставаться опциональными и никогда не запускаться в обычном CI.

См. SECURITY.md, CONTRIBUTING.md и CHANGELOG.md.

Релизы собираются и тестируются из закреплённых GitHub Actions. Теги рабочих процессов создают npm-совместимый архив и аттестацию происхождения сборки GitHub; публикация в npm остаётся отдельным, явно настроенным шагом.

Поддержка проекта

EvoBurrow — бесплатный проект с открытым исходным кодом. Если этот маленький кролик спасёт вашу калибровку в плохой день, вы можете купить daredoole кофе.