js713-lab/sonic-match-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP 서버는 영상을 시청하고 라이선스 안전 BGM 매치, 후크 윈도우, 그리고 에이전트용 ffmpeg ducking 사양을 반환합니다.
개요
대본이 아니라 영상을 보고 후보 명단, 12–20초 훅, 그리고 ffmpeg 덕킹 스펙을 반환합니다. 패키지 / CLI: sonicmatch-mcp. Claude 데스크톱, 커서 및 기타 MCP 클라이언트용 모델 컨텍스트 프로토콜 서버입니다. 인스타그램 릴, 유튜브 쇼트, 틱톡 스타일 클립을 올려주세요. 라이선스가 각 행에 인쇄된 로열티 프리 / 크리에이티브 커먼즈 매칭을 받아보세요. 비디오-투 BGM은 이미 존재합니다. 쐐기는 '음악도 맞춘다'는 것이 아닙니다: - 스크립트가 아니라 를 감시합니다 - + ffmpeg 덕킹 스펙을 반환합니다 - 거짓말 대신 - it is - it입니다 카탈로그 품질이 이 문제를 해결하거나 구할 수 있습니다. 더 많은 도구가 필요하지는 않습니다. 이것을 "YouTube Music 검색 → 스크립트"로 간주해 주세요. 이미 존재하는 기능입니다 (mcp-bgm-recommender). Sonicmatch는 . ingest_video → analyze_video_music → recommend_bgm → preview_mix → export_mix_spec - MIT입니다. - 모든 추천서에 인쇄되어 있습니다. - 여기에는 공식 인스타그램 스티커, 틱톡 상업 음악 라이브러리 트랙, 유튜브 오디오 라이브러리 API 결과가 없습니다.
개요(AI 번역)
라이선스 안전 BGM용 비디오 네이티브 MCP 서버. 스크립트가 아닌 영상을 보고 후보 목록, 12–20초 훅, 그리고 ffmpeg 덕킹 스펙을 반환합니다.
패키지 / CLI: sonicmatch-mcp. Claude 데스크톱, 커서, 코덱스 및 기타 MCP 클라이언트용 모델 컨텍스트 프로토콜 서버입니다. 인스타그램 릴, 유튜브 쇼트, 틱톡 스타일 클립을 올려주세요. 모든 행에 라이선스가 인쇄된 로열티 프리 / 크리에이티브 커먼즈 매칭을 받을 수 있습니다.
비디오-투 BGM은 이미 존재합니다. 쐐기는 '음악도 맞춘다’는 것이 아닙니다:
- 대본이 아니라 영상을 본다
- 훅 윈도우 + ffmpeg 덕킹 스펙을 반환합니다
- 에이전트-네이티브
- 거짓말이 아니라 면허증을 출력한다
카탈로그 품질이 이 문제를 해결하거나 구할 수 있습니다. 더 많은 도구가 필요하지는 않습니다.
이것을 "YouTube Music 검색에서 스크립트"로 취급하지 마세요→ 마세요. 이미 존재하는 스크립트 (mcp-bgm-recommender). Sonicmatch는 영상을 시청합니다.
| 네가 소유하고 있어 | 네가 소유하지 않는다 |
|---|---|
| 로컬 파일 / 공개 URL 인제스트 | 플랫폼 음악 라이선스 |
| 분위기, 에너지 곡선, 말과 침묵, 장면 컷 | 메타/틱톡 “트렌딩 오디오” 그래프 |
| 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": ""
}
}
}
}