Communitygithub.com

adhyanmahajan26-boop/content-studio-mcp

在 Mac Studio 上透過 content-studio MCP 使用 MiniMax-H3 模型(經 mlx-serve)本地生成短 AI 影片片段與音效。當使用者輸入 /video 或要求 AI 生成短片、B-roll、動畫、或圖片轉影片時使用。會先以點選選項詢問品質、形狀、長度與起始點。

content-studio-mcp 是什麼?

Content Studio MCP 是一個專為本地 AI 影片生成設計的技能,讓開發者能在 Mac Studio 上利用 MiniMax-H3 模型快速產生短影片片段。它支援三種品質模式(快速 4-bit、品質 8-bit)、多種畫面比例(直式、橫式、正方形)、以及從文字直接生成或先產生靜態圖片再動畫化的流程。每個影片片段都會自動搭配音軌,並可透過 `generate_video`、`generate_image`、`mux_audio` 等工具組合使用,適合製作社交媒體短片、B-roll 素材或動態展示。此技能特別適合需要在本地環境快速迭代、不需上傳至雲端的開發者與內容創作者。

相容平台✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/adhyanmahajan26-boop/content-studio-mcp/tree/HEAD/skills/video

在你喜歡的 AI 中提問

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

說明文件

/video — 本地 AI 影片片段

工具:content-studio MCP → generate_video, generate_image, mux_audio, free_memory, job_status。

1. 詢問 — 一次提問搭配選項

使用 AskUserQuestion(Claude Code)/ question(OpenCode);否則使用編號列表。 跳過使用者已提供的資訊。

問題選項
模型快速 — MiniMax-H3 4-bit(41 GB,quality:"fast")· 最佳 — MiniMax-H3 8-bit(70 GB,quality:"quality")
形狀直式 Reel 512×896 · 橫式 896×512 · 方形 640×640
長度~2 秒(49 幀) · ~4 秒(97 幀) · ~8 秒(193 幀)
起始點僅文字 · 先產生靜態圖片再動畫化 · 自己的圖片(詢問路徑)

片段會附帶自動生成的配樂。模型會向上取整幀數(49 → 56 幀,24 fps 下約 2.3 秒)。一個小的 512×896 片段在快速模型下約需 2 分鐘。

直式畫面適合人物與街景,但寬廣的地平線鏡頭(海洋、風景)在 512×896 下有時會橫向輸出 — 此類場景建議使用橫式,或在使用片段前檢查一幀。

2. 準備

  • 「先產生靜態圖片再動畫化」:執行 generate_image(品質預設,相同長寬比)並將其路徑傳給 first_frame_image。
  • 使用 8-bit 模型前,請呼叫 free_memory() — 它需要約 70 GB 記憶體。
  • 撰寫鏡頭風格的提示詞:主體 + 動作,攝影機運動(推軌、環繞、手持、慢推入),光線,氛圍。每個片段一個鏡頭。

3. 生成

generate_video(prompt, quality, width, height, num_frames, first_frame_image) → 輪詢 job_status(job_id, wait_seconds=40) 直到完成。

對於多鏡頭作品,將每個鏡頭生為獨立的片段,然後交給 /reel(HyperFrames 編輯)進行剪輯、配上音樂與字幕。

4. 交付

提供 MP4 檔案路徑(位於 ~/ai/content-studio/outputs/video/ 下)、時長與大小。 建議:重新生成(新隨機種子)、加入音樂(/song 後執行 mux_audio),或串成一個 Reel。

長時間工作

工具呼叫約 45 秒內回傳(MCP 客戶端超時為 60 秒)。如果結果顯示 status: "running",請持續呼叫 job_status(job_id) — 每次呼叫最多等待 40 秒 — 並在呼叫間隔告知使用者進度訊息。即使對話或 MCP 伺服器重新啟動,工作仍會繼續執行;list_jobs() 可重新找到它們。

相關技能