Sonic Match MCP

by js713-lab• 153•• Scanned•Claim this listing•Request removal
Design & Mediaai agentsbgmffmpegmcpmodel context protocol

MCP server that watches video footage and returns license-safe BGM matches, hook windows, and ffmpeg ducking specs for agents.

Sonic Match MCP is an open-source mcp server by js713-lab, written mainly in Python, with 153 GitHub stars and the MIT license. Its code was last updated Oct 23, 2026.

Scan summary: scanned Nov 5, 2026 at commit 290c95c. Seen able to read environment and secrets. Scan policy

aboutREADMEsecurityreviews

How to install Sonic Match MCP

Built from the start command in the project's README: docker run --rm -p 127.0.0.1:8765:8765 -v sonic-cache:/data/cache sonicmatch-mcp. Check the README for required keys or settings.

Claude Code · Terminal
claude mcp add sonic-match-mcp -- docker run --rm -p 127.0.0.1:8765:8765 -v sonic-cache:/data/cache sonicmatch-mcp
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "sonic-match-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "127.0.0.1:8765:8765",
        "-v",
        "sonic-cache:/data/cache",
        "sonicmatch-mcp"
      ]
    }
  }
}
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "sonic-match-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "127.0.0.1:8765:8765",
        "-v",
        "sonic-cache:/data/cache",
        "sonicmatch-mcp"
      ]
    }
  }
}
VS Code · Terminal
code --add-mcp '{"name":"sonic-match-mcp","command":"docker","args":["run","--rm","-p","127.0.0.1:8765:8765","-v","sonic-cache:/data/cache","sonicmatch-mcp"]}'

What Sonic Match MCP can touch

  • Run shell commandsNot seen in this scan
  • Run dynamic codeNot seen in this scan
  • Read or write filesNot seen in this scan
  • Read environment and secretsFound in the code by our scan
  • Control a web browserNot seen in this scan
  • Connect to databasesNot seen in this scan
  • Read or send messagesNot seen in this scan
  • Touch money or tradingNot seen in this scan
  • Connect to the internetNo connections seen while running

"Not seen" means our checks did not find it, and the tool may still do it. Covers commit 290c95c, Nov 5, 2026. See the scan policy.

Before you install Sonic Match MCP

AgenticMart scanned Sonic Match MCP on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What it can access

  • An MCP server is a program your AI app starts and talks to. A local one runs with your user's permissions: it can see the files, environment variables and network your account can.

Before you install

  1. Pin the version you reviewed instead of always installing the latest release.
  2. Read the tool list or scripts before the first run, and keep approval prompts on for actions that write, send or delete.
  • Maintained by js713-lab on GitHub, 153 stars and 1 forks. Popularity is not proof of safety.
  • Last code change: Oct 23, 2026.
  • Open-source license: MIT.
Read the scan reportWhat our scan checks

Tools Sonic Match MCP exposes (12)

Listed by the server itself during our scan of commit 290c95c.

  • status

    Show ffmpeg/yt-dlp availability and which music adapters have keys.

  • ingest_video

    Ingest a local video path or public http(s) URL. Accepts a filesystem path or an HTTPS video URL. YouTube/TikTok/Instagram via yt-dlp is OFF unless SONICMATCH_ALLOW_YTDLP=1 (ToS + extractor risk). Rejects file://, http, loopback, and private IPs (SSRF). Size-capped. Extracts durati

  • analyze_video_music

    Produce a structured VideoSonic profile for BGM matching. platform_hint: instagram_story | instagram_reel | tiktok | youtube_short | youtube_long | generic. Uses Gemini video understanding when GEMINI_API_KEY is set; otherwise local ffmpeg/audio heuristics (and optional faster-whis

  • recommend_bgm

    Rank license-safe BGM. Pass asset_id and/or a VideoSonic profile. Defaults instrumental_only=True when speech_coverage > 0.25. catalog: auto | seed | jamendo | freesound | library auto = seed always, plus Jamendo/Freesound/user-library when configured. Each recommendation includes

  • search_music

    Free-text search over seed + optional Jamendo / Freesound / user library.

  • get_track

    Return one track's metadata, license string, attribution text, and URLs.

  • preview_mix

    Mix BGM under the video: hook trim, loop if needed, optional speech ducking. Returns preview mp3 + low-res mp4 paths, the ffmpeg command, and a mix_spec JSON an editor (CapCut / Premiere / DaVinci / your agent) can re-apply. Ducking uses ffmpeg sidechaincompress when the video has spee

  • export_mix_spec

    Export the mix spec + ffmpeg recipe + attribution without requiring a render. This is the editor companion output (CapCut / Premiere / DaVinci / agent). Set render=true to also write preview files (same as preview_mix).

  • suggest_cuts

    Snap detected scene cuts onto a beat grid. Returns EDL-ish spans and intro/peak/outro acts. bpm defaults to the VideoSonic suggested_bpm midpoint, or the track BPM if track_id is set.

  • generate_bed

    Generate a bed when the catalog misses. Always marked source=generated. Refuses unless i_understand_not_commercially_cleared=true. Local fallback is a sine-tremolo demo. NOT cleared for ads. Check Suno/Stable Audio/Lyria terms before swapping in a real generator. Generated tracks are ex

  • save_brand_kit

    Save a brand kit (BPM lock + no vocals + mood whitelist). Pass brand_kit=name to recommend_bgm.

  • analyze_batch

    Analyze up to 20 clips, cluster moods, return one consistent mini-playlist for the series.

Sonic Match MCP is an open-source mcp server by js713-lab, written mainly in Python. MCP server that watches video footage and returns license-safe BGM matches, hook windows, and ffmpeg ducking specs for agents.

At a glance

Stars
153
Forks
1
Language
Python
License
MIT
Created
Sep 2026
Last update
Oct 23, 2026
Type
MCP Server
Price
Free

Topics

ai-agentsbgmffmpegmcpmodel-context-protocolmusic-matchingpythonvideo

Questions about Sonic Match MCP

What is Sonic Match MCP?

MCP server that watches video footage and returns license-safe BGM matches, hook windows, and ffmpeg ducking specs for agents.

Who maintains Sonic Match MCP?

Sonic Match MCP is maintained by js713-lab on GitHub (js713-lab/sonic-match-mcp). AgenticMart lists it from public repository data.

Is Sonic Match MCP safe to use?

AgenticMart scanned Sonic Match MCP on Nov 5, 2026 with automated checks for hidden code, known-malicious packages, leaked secrets and vulnerable dependencies. The result covers one commit under our scan policy, so review what access you give it and check any advisories shown here.

What license does Sonic Match MCP use?

It is published under the MIT license.

Sonic Match MCP alternatives

View more →

Similar mcp servers in Design & Media, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.

NameStarsLicenceLast updatedScan
Sonic Match MCP (this page)
js713-lab
153MITOct 23, 2026Scanned, no flagged issues
Next AI Draw Io
DayuanJiang
37kApache-2.0Nov 1, 2026Scanned, no flagged issues
MCP For Blender
ahujasid
33kMITOct 29, 2026Scanned, no flagged issues
Figma Context MCP
GLips
16kMITOct 27, 2026Scanned, no flagged issues
Nginx UI
0xJacky
12kAGPL-3.0Nov 1, 2026Scanned, no flagged issues
Lamda
firerpa
8.7kMITSep 27, 2026Scanned, no flagged issues