minimax-video-mcp

把 MiniMax Code 的视频生成能力接到第三方中转站上。

工具名、参数、调用流程与 MiniMax 内置的 matrix 视频连接器完全一致， Agent（MiniMax Code / Claude Code / Cursor）侧的写法一个字都不用改。

你只需要做一件事：把 API Key 写进 api.txt。 别的什么都不用改、什么都不用配。

三步接入

1. 拿仓库

git clone https://github.com/FlapPearLabs/minimax-video-mcp.git
cd minimax-video-mcp

2. 写 key

在中转站控制台「管理 API 密钥」创建一个 key，复制 api.txt.example 为 api.txt， 把 key 粘进第一行：

cp api.txt.example api.txt      # Windows: copy api.txt.example api.txt

sk-xxxxxxxxxxxxxxxx

格式很宽松，下面这些都能认出来（# 开头是注释）：

3. 跑一条命令

python install.py

它会：检查环境 → 装依赖 → 读 key → 验证 key 能不能用（只读，不花钱）→ 列出你能用的视频模型 → 跑完整测试 → 打印出 MCP 注册参数。

看到「准备就绪」就成了。

Related MCP server: vicsee-mcp-server

注册到 MiniMax Code

install.py 最后会打印一段 JSON。把它交给 Agent，Agent 调用 mavis 工具即可完成：

mcp create
  name        = minimax-video
  transport   = stdio
  command     = python
  args        = ["<仓库绝对路径>/server.py"]
  description = 第三方中转站 MiniMax 视频生成

env 不用传 —— server.py 会自己去读同目录的 api.txt。 想用环境变量的话，设 VIDEO_API_KEY 即可（优先级更高）。

注册完 mcp list 里能看到 minimax-video 就成了。

或者：直接把这段发给 Agent

仓库里的 接入提示词.md 是一段可以直接粘贴进 MiniMax Code 的提示词， Agent 读完会自己完成克隆、读 key、注册、验证。你也可以直接说：

帮我把 https://github.com/FlapPearLabs/minimax-video-mcp.git 这个项目接进 MiniMax Code。 key 在 api.txt 里。

要把这个项目分享给别人？ 看 给同学的说明.md —— 里面有可以直接群发的文案， 和一段转发给同学自己 AI 助手的提示词。

提供的工具

站点接口

请求体与 MiniMax 官方 V2 逐字段同形（model / content[] / resolution / duration / ratio / callback_url），所以成片效果和走官方一致。

平台规则（提交前本地拦截，不白烧额度）

1. resolution 与 duration 必填

2. 文生视频必须给具体 ratio，且不能是 adaptive

3. 图生视频 ratio 恒按 adaptive 处理

4. 只传 last_frame 会 400，必须与 first_frame 同传

5. 帧模式与参考模式互斥（first_frame/last_frame 不能与 reference_* 同传）

6. POST /v2/h3_context_ir 平台未接入，固定 400

7. 不支持 mm_file://；图片/音频可公网 URL 或 data: 内联；视频只收公网 URL

8. failed 任务已自动退款，不要重复提交

9. 轮询 5~10 秒一次；768P 通常 1~4 分钟，1080P/2K/4K 更久

这些写在 provider.json 的 rules 段，server.py 会在发出请求之前拦下违规组合。

跑测试

python -m unittest discover -s tests -t . -v

覆盖：key 解析的 30+ 种边界情况、content[] 组装、9 条平台规则、mock 端到端、 base_url 故障切换、真实 MCP stdio 协议握手、安装器行为、仓库完整性。

常见问题

虚拟环境（推荐，避免系统 Python 限制）

python -m venv .venv
.venv/Scripts/activate        # Windows
source .venv/bin/activate     # macOS / Linux
pip install -r requirements.txt
python install.py

安全

• api.txt 已在 .gitignore 里，不要提交、不要贴进聊天

• 密钥只走 api.txt 或环境变量 VIDEO_API_KEY，不进命令行参数

• 中转站会留存你提交的 prompt 和素材。公开素材走中转站没问题；工作文档、商业机密建议仍走官方直连

许可

MIT