Communitygithub.com

adhyanmahajan26-boop/content-studio-mcp

在 Mac Studio 上本地使用 MiniMax-H3 模型生成带有音效的短视频 AI 片段。用户输入 /video 或要求生成 AI 视频、B-roll、动画或图像转视频时使用。

content-studio-mcp 是什么?

这个技能使 AI 助手能够通过 content-studio MCP 在本地 Mac Studio 上利用 MiniMax-H3 模型生成短视频 AI 片段。它支持两种质量模式:快速的 4 位量化(41 GB)和高质量的 8 位量化(70 GB),以及多种画面比例(垂直竖屏 512×896、横向 896×512、方形 640×640)和时长选项(约 2 秒、4 秒、8 秒)。用户可通过 /video 命令触发,技能以选项形式询问质量、画面比例、时长和起始方式(纯文本、先生成静态图像再动画、或使用用户提供的图片)。生成过程包括调用 generate_video 创建片段、mux_audio 混入音效,以及 job_status 轮询进度。对于长时间任务,即使聊天或 MCP 服务器重启,任务也会继续运行,可通过 list_jobs 恢复。

兼容平台✓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 位(41 GB,quality:"fast")· 最佳 — MiniMax-H3 8 位(70 GB,quality:"quality")
画面比例竖屏 512×896 · 横向 896×512 · 方形 640×640
时长~2 秒(49 帧) · ~4 秒(97 帧) · ~8 秒(193 帧)
起始方式仅文本 · 先生成一张静态图,再制作动画 · 我自己的图片(询问路径)

片段自带生成的配乐。模型会对帧数向上取整 (49 → 56 帧 ≈ 2.3 秒,24 fps)。在快速模型上,一个 512×896 的小片段约需 2 分钟。

竖屏适合人物和街景,但宽阔的地平线镜头 (海洋、风景)有时会在 512×896 下出现侧翻——针对这类场景请使用横向, 或者在使用片段前先检查一帧。

2. 准备

  • “先生成一张静态图”:运行 generate_image(质量预设,相同宽高比),然后 将其路径作为 first_frame_image 传递。
  • 在使用 8 位模型之前,调用 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),或制作合成片段。

长时间任务

工具调用在约 45 秒内返回(MCP 客户端的超时时间为 60 秒)。如果结果显示 status: "running",持续调用 job_status(job_id) — 每次调用最多等待 40 秒 — 并在两次调用之间告知用户进度。即使聊天或 MCP 服务器重新启动,任务也会继续运行; list_jobs() 可以重新找到它们。

相关技能