Sonicmatch
Sonicmatch — MCP-сервер сообщества (автор — js713-lab). Анализ настроения и темпа видео и подбор лицензионно чистой музыки. Ставится через uvx или через pip. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- js713-lab
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- python
Уровень риска: high
Читает видео и пишет файлы предпросмотра и кэш; при заданных ключах обращается к Gemini, Jamendo и Freesound. Лицензии треков нужно проверять.
Настройка клиентов
{
"code": "[mcp_servers.sonicmatch]\ncommand = \"uvx\"\nargs = [\"--from\", \"git+https://github.com/js713-lab/sonic-match-mcp.git\", \"sonicmatch-mcp\"]\n\n[mcp_servers.sonicmatch.env]\nGEMINI_API_KEY = \"\"\nJAMENDO_CLIENT_ID = \"\"\nFREESOUND_API_KEY = \"\"",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Или команда: codex mcp add sonicmatch -- uvx --from git+https://github.com/js713-lab/sonic-match-mcp.git sonicmatch-mcp",
"verified": "docs"
}
Что умеет
Sonicmatch (пакет sonicmatch-mcp) — MCP-сервер, который подбирает фоновую музыку для коротких видео с учётом лицензий. Он анализирует само видео, а не сценарий: настроение, кривую энергии, долю речи и тишины, смены сцен и темп. На выходе — короткий список треков, окно «хука» длиной 12–20 секунд и спецификация приглушения музыки под речь для ffmpeg. Подходит для роликов в формате Reels, Shorts и TikTok.
Инструменты:
status— наличие ffmpeg, ключей, размер базового каталога и включённые защитные ограничения.ingest_video— локальный путь или HTTPS-ссылка превращаются вasset_id(байты видео через сервер не передаются). Ссылки на платформы требуютSONICMATCH_ALLOW_YTDLP=1.analyze_video_music— настроение, энергия, речь, сцены, окно хука, BPM и поисковые запросы.recommend_bgm— 3–7 треков с объяснением, лицензией и точками входа и выхода.search_musicиget_track— поиск по каталогам и карточка трека с лицензией и текстом атрибуции.preview_mixиexport_mix_spec— обрезка хука, зацикливание, приглушение под речь, файлы предпросмотра, команда ffmpeg и спецификация сведения для CapCut, Premiere или DaVinci.suggest_cuts— сетка долей, привязка склеек к BPM, EDL-подобная разметка вступления, пика и финала.generate_bed,save_brand_kit,analyze_batch— демо-подложка с пометкойsource=generated, сохранение фирменного набора (BPM, настроения, без вокала) и пакетный анализ до 20 клипов с общим мини-плейлистом.
Лицензия указывается в каждой строке. Треки с некоммерческой лицензией и сгенерированные подложки никогда не попадают в автоматические рекомендации. Для каждого трека выводится предупреждение о Content ID, а риск никогда не помечается как «снят».
Кому подойдёт
- Монтажёрам и SMM-специалистам, которые быстро подбирают музыку для коротких роликов.
- Владельцам собственных библиотек Epidemic Sound или Artlist: их можно подключить как JSON-файл.
- Разработчикам видеопайплайнов с агентами.
Похожие серверы — в категории медиа и творчество.
Установка
Нужны Python 3.10+, ffmpeg и ffprobe в PATH. Сейчас сервер ставится из git: uvx --from git+https://github.com/js713-lab/sonic-match-mcp.git sonicmatch-mcp; после публикации на PyPI будет достаточно uvx sonicmatch-mcp. Сервер работает без ключей на базовом каталоге примерно из 20 треков. Необязательные переменные: GEMINI_API_KEY (анализ видео через Gemini), JAMENDO_CLIENT_ID, FREESOUND_API_KEY, SONICMATCH_LIBRARY_PATH (собственная библиотека), SONICMATCH_MAX_DOWNLOAD_MB (по умолчанию 200).
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"sonicmatch": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/js713-lab/sonic-match-mcp.git",
"sonicmatch-mcp"
],
"env": {
"GEMINI_API_KEY": "",
"JAMENDO_CLIENT_ID": "",
"FREESOUND_API_KEY": ""
}
}
}
}Файлы: claude_desktop_config.json для Claude Desktop, .cursor/mcp.json в проекте или ~/.cursor/mcp.json для Cursor, ~/.codex/config.toml для Codex. Ключи можно оставить пустыми.
Проверка
Выполните codex mcp list — в списке должен быть sonicmatch. Вызов status покажет, найден ли ffmpeg и какие ключи заданы.
Примеры задач
Я положил ./clip.mp4. Проанализируй его для Reels и предложи 5 инструментальных треков, затем сведи лучший с приглушением под речь и дай команду ffmpeg.Разбери эти 10 клипов серии и подбери общий мини-плейлист без вокала, около 110 BPM.Риски
- Файлы. Сервер читает ваши видео и записывает файлы предпросмотра и сведения на диск, а также кэш в
~/.cache/sonicmatch-mcp. - Сеть и ключи. При заданных ключах обращается к Gemini, Jamendo и Freesound; удалённая загрузка только по HTTPS, без локальных и частных адресов, с ограничением размера.
- Лицензии и Content ID. Лицензия CC не гарантирует отсутствие претензий; CC-BY требует атрибуции, CC-BY-NC не подходит для рекламы.
- yt-dlp. Загрузка с платформ выключена по умолчанию: экстракторы ломаются и могут нарушать правила площадок.
- HTTP-режим (
--http) без авторизации — держите его только на loopback. Публичный хостинг проекта списывает кредиты за вызовы.
Частые вопросы
Можно ли использовать треки в рекламе?
Только с подходящей лицензией; для рекламы автор советует подключить собственную лицензированную библиотеку.
Нужны ли ключи API?
Нет, сервер работает на базовом каталоге; ключи расширяют анализ и поиск.
Публикует ли сервер ролики в Instagram?
Нет, он только подбирает музыку и готовит сведение.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
FunASR
Локальная расшифровка аудио моделями FunASR и SenseVoice.
OpenScreen
Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.
ffmpeg-skill
Локальные инструменты FFmpeg для видео и аудио.
davinci-resolve-mcp
Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.