Cochlea — MCP-сервер для Claude Code: рендер и анализ аудио
MCP-сервер для офлайн-рендера аудио из партитуры в формате RON и детального анализа WAV, FLAC, mp3, ogg без воспроизведения — агент получает JSON с громкостью, питчем, онсетами, темпом и спектрограмму.
Открыть на GitHubЧто делает Cochlea
Агент пишет партитуру данными (RON-формат), рендерит PCM командой cochlea render, затем считывает результат через cochlea probe — JSON-отчёт с интегрированной громкостью (LUFS), true peak, онсетами, распознанными нотами в поле pitch.melody, тональностью, темпом и MFCC. Спектрограмма генерируется в PNG одной командой cochlea spectro для одного vision-вызова вместо перебора сэмплов. Цикл замыкается через cochlea render --verify: встроенные в партитуру ассерты (.true_peak_below(), .pitch_matches_score(), .silent_after()) проверяются автоматически, агент ретраит без участия человека.
Все инструменты читают WAV, FLAC (bit-exact декодирование), mp3 и ogg, FFmpeg не нужен. Флаги --from и --to режут фрагмент с точностью до фрейма, времена в отчёте пересчитываются относительно среза. Партитура задаёт темп, размер, треки с пресетами инструментов (Instrument::preset("saw_led")), ноты и автоматизацию параметров (cutoff, резонанс) на временной сетке в тиках. Экономика в том, что 3-минутный рендер занимает ~66 МБ PCM, а его probe-отчёт — несколько килобайт JSON.
Какие задачи решает
- рендерить аудио из партитуры без DAW и проверять результат программно
- анализировать loudness, pitch, onsets и tempo любого аудиофайла через JSON
- генерировать спектрограмму для агента вместо чтения сэмплов
- проверять ассерты партитуры (пик, питч, тишина) автоматически
- импортировать MIDI в формат партитуры или транскрибировать аудио обратно
Примеры запросов агенту
- Отрендери партитуру из
beat.ronвmix.wav, запусти проверку ассертов - Проанализируй
vocal.mp3с 42 до 44.5 секунды, выведи JSON с онсетами и питчем - Построй mel-спектрограмму
drums.wavвspec.pngс аннотациями битов и онсетов
Как установить Cochlea
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Cochlea
Как установить Cochlea в Claude Code?
Добавь MCP-сервер в конфигурацию Claude Code, указав путь к исполняемому файлу cochlea и аргумент mcp. Собери бинарник из репозитория richer-richard/cochlea через cargo build --release.
Что делает Cochlea?
Рендерит аудио из партитуры (RON-формат) в детерминированный PCM, анализирует WAV/FLAC/mp3/ogg без воспроизведения — выдаёт JSON с громкостью, онсетами, распознанными нотами, темпом, тональностью и спектрограмму в PNG. Агент может проверять встроенные ассерты партитуры автоматически.
Какие форматы читает cochlea probe?
WAV, FLAC (bit-exact декодирование), mp3 и ogg. FFmpeg не требуется, партитура нужна только для рендера и verify, анализ работает с любым аудиофайлом.
