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. Лицензии треков нужно проверять.

Настройка клиентов

codex
{
    "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.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники