MCP服务器会观看视频素材，并返回许可安全的BGM匹配、hook窗口和ffmpeg的ducking规范。
概览
看录像——不是剧本——然后返回候选名单、12–20秒钩子和ffmpeg躲避样本。 包 / CLI：sonicmatch-mcp。一个适用于Claude桌面、光标及其他MCP客户端的模型上下文协议服务器。发布Instagram短视频、YouTube短视频或TikTok风格的视频。获得免版税/知识共享匹配，每行都印有许可证。 视频转背景音乐已经存在了。楔子不是“我也匹配音乐”： - 它监视 ，而不是脚本 - 返回 + ffmpeg 的 ducking spec - it is - it 而不是 lyly（说谎） 目录质量会解决或拯救这个问题。更多工具不会。 请把这当作“YouTube Music搜索中的脚本→”。这已经存在了（mcp-bgm-recommender）。Sonicmatch会观看。 ingest_video → analyze_video_music → recommend_bgm → preview_mix → export_mix_spec - 这是麻省理工学院。- 它印在每个推荐信上。- 这里没有官方Instagram贴纸、TikTok商业音乐库曲目或YouTube音频库API结果。
概述（AI 翻译）
视频原生MCP服务器，用于许可安全的背景音乐。 观看素材——而非剧本——并返回候选名单、12至20秒的钩子和ffmpeg的鸭子规格。
软件包 / CLI：sonicmatch-mcp。一个适用于Claude桌面、光标、Codex及其他MCP客户端的模型上下文协议服务器。发布Instagram短视频、YouTube短视频或TikTok风格的视频。获得免版税/知识共享匹配，每行都印有许可证。
视频转背景音乐已经存在了。楔子不是“我也匹配音乐”：
- 它观看的是录像，而不是剧本
- 返回钩窗口 + ffmpeg 蹲守规格
- 它是agent-native
- 它打印许可证而不是撒谎
目录质量会解决或拯救这个问题。更多工具不会。
不要把这当作“YouTube Music搜索→脚本”。那已经存在了（mcp-bgm-recommender。Sonicmatch观看了视频。
| 你拥有 | 你不拥有 |
|---|---|
| 本地文件 / 公共URL导入 | 平台音乐许可 |
| 情绪、能量曲线、语音与沉默、场景切换 | Meta/TikTok“热门音频”图表 |
| CC / 免版税目录 + 可选付费适配器 | Spotify / IG 官方库 |
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Sonicmatch
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, Codex, 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 preview
Do not treat this as “script in → YouTube Music search out.” That already exists (mcp-bgm-recommender). Sonicmatch watches the video.
| You own | You do not own |
|---|---|
| Local file / public URL ingest | Platform music licenses |
| Mood, energy curve, speech vs silence, scene cuts | Meta/TikTok “trending audio” graph |
| CC / royalty-free catalogs + optional paid adapters | Spotify / IG official libraries |
| Ranked tracks, preview URLs, mix spec, ffmpeg | Auto-publish to Instagram |
North star: ingest_video → analyze_video_music → recommend_bgm → preview_mix → export_mix_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.
安装
uvx --from git+https://github.com/js713-lab/sonic-match-mcp.git sonicmatch-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": ""
}
}
}
}