Sonicmatch MCP server
io.github.js713-lab/sonicmatch-mcp·v0.2.0·153 starsAnalyze video mood and pace, then recommend license-safe BGM with a mix spec.
153 stars
Reviews
Write oneNobody has reviewed Sonicmatch yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Sonicmatch tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it
- –Code scanpackage could not be scannedn/a
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 4 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Sonicmatch compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 73/100
- higher than 42% of 1,337 Media servers
- GitHub stars
- 153
- more than 95% of 715 Media servers
Install Sonicmatch in Claude Code, Cursor or VS Code
The registry entry has no remote endpoint or installable package.
What the publisher says
From the Sonicmatch repository's README, as published. We do not edit it. Read it on GitHub
Sonicmatch
<!-- mcp-name: io.github.js713-lab/sonicmatch-mcp -->
Video-native MCP server for license-safe BGM. Watches the footage — not the script — and returns a shortlist, a 12–20s hook, and an ffmpeg ducking spec.
Package / CLI: sonicmatch-mcp. A Model Context Protocol server for Claude Desktop, Cursor, and other MCP clients. Drop an Instagram Reel, YouTube Short, or TikTok-style clip. Get royalty-free / Creative Commons matches with the license printed on every row.
Video-to-BGM already exists. The wedge is not “I also match music”:
- it watches the footage, not the script
- it returns a hook window + ffmpeg ducking spec
- it is agent-native
- it prints the license instead of lying
Catalog quality will kill or save this. More tools will not.
Video or URL in
→ scene / mood / pace / speech analysis
→ license-safe BGM shortlist
+ beat/cut hints
+ optional mix previewDo not treat this as “script in → YouTube Music search out.” That already exists (mcp-bgm-recommender). Sonicmatch watches the video.
North star: ingestvideo → analyzevideomusic → recommendbgm → previewmix → exportmix_spec
License warning (read this)
- The code is MIT.
- Every track has its own license. It is printed on every recommendation.
- Nothing here is an official Instagram sticker, TikTok Commercial Music Library track, or YouTube Audio Library API result.
- Do not recommend commercial pop unless the adapter is explicitly a user-owned licensed library.
- CC-BY still needs attribution. CC-BY-NC is not ok for ads / shops. Non-commercial tracks are never auto-recommended.
- For ads / shops, wire a user-owned Artlist / Epidemic JSON (examples/user_library.example.json). Do not scrape those sites.
- Content ID can still hit you if you point at the wrong source. A CC label is not a waiver.
Demo
I dropped ./clip.mp4. Analyze it for an Instagram Reel and recommend 5 instrumental BGMs. Then mix the top pick with ducking and give me the ffmpeg command.
That prompt is the product. Install below, wire Claude Desktop or Cursor, paste it.
Quick start
Requires Python 3.10+ and ffmpeg / ffprobe on PATH. yt-dlp is optional and off by default (SONICMATCHALLOWYTDLP=0) because platform extractors break and may violate ToS. Prefer a local file.
pip install git+https://github.com/js713-lab/sonic-match-mcp.git
sonicmatch-mcp # or: python3 -m sonicmatchWith uv, no clone:
uvx --from git+https://github.com/js713-lab/sonic-match-mcp.git sonicmatch-mcpFrom a clone (editable + tests):
git clone https://github.com/js713-lab/sonic-match-mcp.git
cd sonic-match-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env # optional keys
# stdio (Claude Desktop / Cursor)
sonicmatch-mcp
# streamable HTTP (web editors)
sonicmatch-mcp --http --port 8765Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Sonicmatch: common questions
- Is Sonicmatch MCP server safe?
- Mostly: it is graded B (73/100). Read the Sonicmatch safety report
- Does Sonicmatch need an API key?
- Yes. The registry entry asks for
GEMINI_API_KEY,JAMENDO_CLIENT_ID,FREESOUND_API_KEY. - Is Sonicmatch maintained?
- The last commit was 25 days ago (2026-10-10). The latest release is v0.2.0.
- What can I use instead of Sonicmatch?
- Servers from other publishers that do the same job: Audio MCP server, Katto MCP server and Remove AI Watermarks MCP server.
- How does Sonicmatch compare with other Media MCP servers?
- safety score 73/100 (higher than 42% of 1,337 Media servers); github stars 153 (more than 95% of 715 Media servers). Full comparison.
Alternatives to Sonicmatch
Same job from other publishers: the closest match first, then the best rated.
- AudioEdit, analyze and convert audio: loudness, spec checks, denoise, EQ, cuts, BPM, key. No ffmpeg.not reviewedEstablishedA
- KattoAI video clipping MCP: long videos and podcasts into scored, captioned 9:16 shorts.5.0(1)GrowingB
- Remove AI WatermarksIdentify and remove AI watermarks and provenance metadata from your own images and video.not reviewedWidely usedA
OpenshortsTurn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube.not reviewedEstablishedA- FFmpegTrim, convert, resize, compress, and remix audio and video.not reviewedEstablishedA