Communitygithub.com

modbender/skill-library-mcp

端到端生成 AI 音樂影片。使用 Suno 創作音樂,以 OpenAI/Seedream/Google/Seedance 產生視覺素材,並透過 ffmpeg 組裝成完整音樂影片。支援附時間戳的歌詞(自動 SRT)、Suno 原生音樂影片生成、幻燈片/影片/混合模式。每次生成皆有基於 Token 的成本追蹤。

skill-library-mcp 是什麼?

這個「AI 音樂影片生成器」技能提供了一條完整的管線,能將 AI 生成的音樂與 AI 驅動的視覺內容無縫結合成為專業的音樂影片。它整合了多個頂級 AI 服務:使用 SunoAPI 生成帶歌詞的音樂,並透過 OpenAI、Seedream、Google 等提供者創建圖像或影片剪輯。其核心工作流程包含四個步驟:從歌詞規劃場景、生成音樂、生成視覺素材(幻燈片或影片),最後使用 ffmpeg 進行組裝,並可選擇疊加自動擷取或自訂的 SRT 字幕。此技能支援三種主要的影片模式——成本低廉的幻燈片模式、高品質的影片剪輯模式,以及結合兩者的混合模式——讓用戶可以彈性平衡成本與品質。此外,它還支援 Suno 原生的音樂影片生成、基於 Token 的詳細成本估算與追蹤,以及「角色」功能,可用於在多首歌曲中保持一致的聲樂風格。此技能設計用於在支援 AI 代理的環境中執行,例如 Claude Code、Cursor 或 Codex,並需要設定必要的 API 金鑰(SUNO_API_KEY 和 OPENAI_API_KEY)。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/modbender/skill-library-mcp/tree/HEAD/data/ai-music-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

AI 音樂影片生成器

建立完整的音樂影片:AI 音樂 + AI 視覺 + ffmpeg 組裝。

快速開始

"90년대 보이밴드 풍 한국어 노래 만들어줘" → 僅音樂
"발라드 뮤비 만들어줘" → 音樂 + 幻燈片 MV
"EDM 뮤비 풀영상으로" → 音樂 + 影片剪輯 MV
"Suno 뮤비로 만들어줘" → Suno 原生音樂影片

工作流程

1. 根據歌詞/氛圍規劃場景

在生成之前,先建立 prompts.json — 根據歌曲的歌詞、氛圍和敘事衍生出的場景描述陣列。一首 3 分鐘的歌曲約需 8-12 個場景。

[
  {"prompt": "Neon-lit city street at night, rain reflections", "type": "image"},
  {"prompt": "Camera slowly panning across a rooftop at sunset", "type": "video"},
  "A lone figure walking through cherry blossoms"
]

2. 生成音樂

bash scripts/suno_music.sh \
  --prompt "가사 또는 설명" \
  --style "90s boy band pop, korean" \
  --title "너만을 원해" \
  --model V4_5ALL --custom \
  --outdir /tmp/mv_project

選項:

  • --model V4_5ALL(預設)、V5、V4_5PLUS、V4_5、V4
  • --instrumental — 無歌聲
  • --vocal-gender m|f — 歌聲性別提示
  • --negative-tags "Heavy Metal, Drums" — 要避免的風格
  • --music-video — 生成 Suno 原生音樂影片(MP4)
  • --dry-run — 僅成本檢查

角色(일관된 스타일 유지):

  • --persona-id ID — 使用現有角色(用相同歌聲/風格生成多首歌曲)
  • --create-persona — 從生成的歌曲建立角色 → 儲存為 persona.json
  • --persona-name "이름" / --persona-desc "설명" / --persona-style "스타일"

自動功能:

  • 🎤 附時間戳的歌詞:非純音樂曲目會自動擷取歌詞時間戳,並儲存為 {outdir}/lyrics.srt
  • 🎬 Suno 原生 MV:使用 --music-video 參數,Suno 會直接生成可視化的 MP4 影片
  • 🎭 角色:使用 --create-persona 參數,可提取聲音/風格特徵以供重複使用

3. 生成視覺素材(自訂 MV 流程)

bash scripts/gen_visuals.sh \
  --mode slideshow \
  --prompts-file /tmp/mv_project/prompts.json \
  --image-provider seedream \
  --outdir /tmp/mv_project

或使用 OpenAI(較便宜,解析度較低):

bash scripts/gen_visuals.sh \
  --mode slideshow \
  --prompts-file /tmp/mv_project/prompts.json \
  --image-provider openai --image-model gpt-image-1-mini --image-quality medium \
  --outdir /tmp/mv_project

在花費前,請先加上 --dry-run 來查看成本估算。

4. 組裝

bash scripts/assemble_mv.sh \
  --audio /tmp/mv_project/track_0_xxx.mp3 \
  --outdir /tmp/mv_project \
  --output /tmp/mv_project/final_mv.mp4 \
  --transition fade

字幕行為:

  • 自動偵測 {outdir}/lyrics.srt 並自動疊加歌詞
  • --subtitle /path/to/custom.srt — 使用自訂 SRT 檔案
  • --no-subtitle — 完全停用歌詞疊加

模式

模式視覺素材最佳用途成本(10 個場景)
slideshowAI 圖像快速、便宜~$0.02 (mini low) / ~$0.09 (mini med) / ~$0.45 (Seedream)
videoAI 影片剪輯高品質~$1.40 (Seedance Lite) / ~$8.00 (Sora 2)
hybrid兩者混合平衡~$0.50-$4.00
suno-nativeSuno MV最簡單僅需 Suno 點數

圖像成本基於 Token — 實際帳單金額可能低於所列估算。請使用 --dry-run 獲取精確成本。

提供者選項

圖像: --image-provider seedream(建議)、openai 或 google-together 圖像模型 (OpenAI): --image-model gpt-image-1-mini(預設,便宜)或 gpt-image-1(高品質) 影片: --video-provider sora(預設)、sora-pro、seedance-lite、seedance-pro、veo-fast、veo-audio 品質: --image-quality low|medium|high

成本追蹤

每個腳本皆會在執行前後輸出成本。務必先使用 --dry-run。 成本資料會儲存至 {outdir}/cost_estimate.json 和 {outdir}/visuals_meta.json。

環境變數

export SUNO_API_KEY="your-sunoapi-key"      # 必要 — sunoapi.org
export OPENAI_API_KEY="your-openai-key"     # 必要 — 圖像 + Sora 影片
export BYTEPLUS_API_KEY="your-byteplus-key" # 選用 — Seedream 4.5(建議用於圖像)
export TOGETHER_API_KEY="your-together-key" # 選用 — Seedance, Veo, Imagen
export SUNO_CALLBACK_URL=""                 # 選用 — 請參閱下方的 Callback URL

⚠️ 必要金鑰: 在執行任何腳本前,必須設定 SUNO_API_KEY 和 OPENAI_API_KEY。 若使用 Seedream 圖像提供者,則需要 BYTEPLUS_API_KEY(請在 console.byteplus.com 註冊,可獲得 200 張免費圖像)。 僅在使用 Seedance/Veo/Imagen 提供者時才需要 TOGETHER_API_KEY。

回調 URL

Suno API 在音樂生成請求中需要一個 callBackUrl 欄位。 預設情況下,若未設定 SUNO_CALLBACK_URL,腳本會使用 https://localhost/noop 作為一個無害的空操作端點(一個無法連線的 localhost URL,可有效停用回調)。

若要自訂: 將 SUNO_CALLBACK_URL 設為您自己的端點,或設為 您控制的任何虛擬 URL。回調負載包含任務中繼資料和 音訊 URL — 不會傳送 API 金鑰。

若要停用: 設定 SUNO_CALLBACK_URL=https://localhost/noop 或任何無法連線的 URL。 生成功能仍可透過輪詢正常運作;回調並非腳本運作的必要條件。

角色工作流程(채널 컨셉 유지)

如同 YouTube 頻道,當需要以一致的風格創作多首歌曲時:

# 1. 生成第一首歌 + 建立角色
bash scripts/suno_music.sh \
  --prompt "코드 리뷰하며 듣는 노래" \
  --style "indie rock, energetic, coding vibe" \
  --title "Pull Request" \
  --custom --create-persona \
  --persona-name "개발자 노동요 싱어" \
  --persona-desc "개발자가 코딩하며 듣기 좋은 에너지 넘치는 보컬. 인디록, 일렉, 팝 장르를 넘나든다." \
  --persona-style "indie rock, electronic, developer work music" \
  --outdir /tmp/dev-bgm-01

# 2. 從 persona.json 確認 personaId
cat /tmp/dev-bgm-01/persona.json

# 3. 用同一個角色生成下一首歌 — 保持歌聲/風格一致
bash scripts/suno_music.sh \
  --prompt "야근하면서 듣는 노래" \
  --style "electronic pop, night coding" \
  --title "Midnight Deploy" \
  --custom --persona-id <PERSONA_ID> \
  --outdir /tmp/dev-bgm-02

角色能記住聲樂特徵與音樂風格,有助於維持整個頻道的一致性。

先決條件

  • curl、python3、ffmpeg(用於組裝)

參考資料

  • SunoAPI 詳細資訊: 閱讀 references/sunoapi.md
  • 視覺提供者詳細資訊: 閱讀 references/visual-providers.md

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

modbender/skill-library-mcp

Paid acquisition strategy, budget allocation, and avoiding common advertising mistakes across platforms

modbender/skill-library-mcp

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all wit...

modbender/skill-library-mcp

Borrow from Aave via credit delegation. Agent self-funds by borrowing against delegator collateral. Supports borrow, repay, health checks. Works on Aave V2/V3.

modbender/skill-library-mcp

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

modbender/skill-library-mcp

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

modbender/skill-library-mcp

AI代码编辑器规则模板集合 - 为Cursor、Windsurf、Claude Code、Cline等AI编辑器提供项目规则配置。适用于需要配置AI编码助手规则的开发者,包含全栈Web、移动端、Vue3+SpringBoot等技术栈模板。

modbender/skill-library-mcp

Generate landing page code from product descriptions

modbender/skill-library-mcp

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

modbender/skill-library-mcp

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

modbender/skill-library-mcp

The video AI notes tool is provided by Baidu. Based on the video download address provided by the user, it downloads and parses the video, and finally generates AI notes corresponding to the video (a total of three types of notes can be generated: document notes, outline notes, and image-text notes).

modbender/skill-library-mcp

Automated appointment management for beauty salons, clinics, studios, and photo booths. Handles booking requests, calendar sync, conflict detection, reminders, no-show tracking, and waitlist management.

modbender/skill-library-mcp

Bird identification, life list tracking, and trading card generation. Use this skill when the user: sends a bird photo to identify, says "set up my Birdfolio" or "set my region", asks "how's my checklist", asks "Birdfolio progress", asks "how many birds have I found", asks "show my Birdfolio" or "show my life list", asks "what's my rarest bird", or asks "tell me about [bird species]". Handles everything from first-time setup through ongoing life list tracking and visual trading card generation.

modbender/skill-library-mcp

Multi-project task and research management (JSON-first CLI)

modbender/skill-library-mcp

Track stock and crypto portfolios with CLI - real-time prices, P&L, dividend tracking, multiple portfolios

modbender/skill-library-mcp

Track cryptocurrency portfolios with real-time prices, P&L calculations, and allocation analysis. Query Bitcoin, Ethereum, Solana and 10,000+ token holdings.

modbender/skill-library-mcp

加密貨幣Portfolio追蹤 - 支援TRON/ETH/BSC,分析持倉、收益、Gas費用

modbender/skill-library-mcp

Lead strategy with competitive analysis, strategic planning, growth roadmaps, and business portfolio management.

modbender/skill-library-mcp

Create ATS-optimized resumes and CVs with proper structure, metrics, and industry targeting.

modbender/skill-library-mcp

Use this skill when the user asks to build, create, design, develop, or improve ANY frontend interface, web page, UI component, or visual element. This includes: - Building landing pages, websites, web apps, dashboards, portfolios, or any web interface - Creating UI components (buttons, forms, cards, navbars, modals, etc.) - Designing pages with React, Vue, Next.js, Svelte, or any frontend framework - Adding styling or improving visual design of existing components - Implementing specific design aesthetics (modern, dark, minimalist, brutalist, etc.) - User mentions "frontend", "UI", "UX", "design", "interface", "web design", or "styling" - User asks for "beautiful", "modern", "professional", "clean", or any aesthetic adjective - User requests help with CSS, Tailwind, styled-components, or any styling approach This skill automatically retrieves the appropriate design system prompt (Neo-brutalism, Modern Dark, Bauhaus, Cyberpunk, Material, etc.) to help create visually distinctive, production-grade frontend...

modbender/skill-library-mcp

Native video analysis using Google Gemini API. Upload and analyze video files — describe scenes, extract text/UI, answer questions about content, transcribe speech, identify objects and actions. Use when: (1) User sends a video file and wants it analyzed, (2) Video summarization or description needed, (3) Extracting text, UI elements, or information from screen recordings, (4) Answering questions about video content, (5) Comparing multiple videos, (6) Analyzing tutorials, demos, or walkthroughs.

相關技能