js713-lab/sonic-match-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCPサーバーは映像映像を視聴し、ライセンスに安全なBGMマッチ、フックウィンドウ、ffmpegのダッキング仕様をエージェント向けに返します。
概要
脚本ではなく映像を見て、ショートリスト、12〜20秒のフック、そしてffmpegのダッキングスペックを返します。 パッケージ/CLI:sonicmatch-mcp。Claude Desktop、カーソル、その他のMCPクライアント向けのモデルコンテキストプロトコルサーバーです。Instagramリール、YouTubeショート、TikTok風のクリップを投稿できます。ライセンスが各行に印刷されたロイヤリティフリー/クリエイティブ・コモンズマッチを入手できます。 ビデオからBGMへの変換はすでに存在しています。くさびは「音楽も合わせる」ではありません: - スクリプトではなく を監視する - + ffmpeg のダッキングスペックを返す - 嘘をつく代わりに - it is - it カタログの品質がこれを終わらせるか救うかにつながります。ツールを増やすことは難しいです。 これは「YouTube Musicの検索→スクリプト」として扱ってください。それはすでに存在しています(mcp-bgm-recommender)。Sonicmatchは ingest_video → analyze_video_music → recommend_bgm → preview_mix → export_mix_spec - それはMITです。- すべての推薦に印刷されています。- ここに公式のInstagramステッカー、TikTokの商業音楽ライブラリのトラック、YouTubeオーディオライブラリAPIの結果はありません。
概要（AI 翻訳）
ライセンスセーフなBGM用のビデオネイティブMCPサーバー。 脚本ではなく映像を視聴し、ショートリスト、12〜20秒のフック、そしてffmpegのダッキング仕様を返します。
パッケージ/CLI: sonicmatch-mcp。Claude Desktop、カーソル、Codex、その他のMCPクライアント向けのモデルコンテキストプロトコルサーバーです。Instagramリール、YouTubeショート、またはTikTokスタイルのクリップを投稿できます。すべての行に印刷されたライセンスで、ロイヤリティフリー/クリエイティブ・コモンズのマッチングを手に入れます。
ビデオからBGMへの変換はすでに存在しています。くさびは「音楽も合わせる」ではありません:
- 映像自体を監視し、脚本を見ているわけではありません
- フックウィンドウ + ffmpeg ダッキングスペックを返します
- それはエージェントネイティブです
- 嘘をつくのではなく、ライセンスを印刷する
カタログの品質がこれを終わらせるか救うかにつながります。ツールを増やすことは難しいです。
これを「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": ""
}
}
}
}