hoobnn-minimax-mcp

# MiniMax MCP 独立重写的 MiniMax stdio MCP，重点支持 H3 V2。包名 `hoobnn-minimax-mcp`，不是官方 `minimax-mcp`，不依赖后者。沿用本仓库的连接池、超时取消、任务持久化与交付恢复机制。 `0.3.0` 的 `generate_video` 新增 `MiniMax-H3-Highspeed`（仅 768P）与 `MiniMax-H3-Lite`（480P / 768P，多模态参考需显式指定具体 `ratio`），均为 4–15 秒、不支持 2K。 `0.2.0` 将 `enhance_video_prompt` 更名为 `create_h3_context_ir_task`，与官方「创建 H3-Context-IR 任务」对应；旧名不保留别名，这是不兼容变更。 ## 安装与迁移 从 PyPI 安装： ```bash uv tool install hoobnn-minimax-mcp ``` 本地开发可在仓库根目录运行 `uv tool install ./servers/minimax`。 客户端命令改为 `~/.local/bin/hoobnn-minimax-mcp` 的绝对路径，不带参数。原来的 `uvx minimax-mcp -y` 启动的是官方包，单纯升级它不会获得本实现。需要重启 MCP 客户端后才会发现新工具。 | 环境变量 | 用途 | |---|---| | `MINIMAX_API_KEY` | 必填，与 API 区域匹配；不写入任务记录 | | `MINIMAX_API_HOST` | 默认 `https://api.minimax.cn`；也接受已有的 `https://api.minimaxi.com` 或国际站 `https://api.minimax.io` | | `MINIMAX_OUT_DIR` | 默认 `~/Downloads/minimax`，兼容旧 `MINIMAX_MCP_BASE_PATH` | | `MINIMAX_RESOURCE_MODE` | `local`（默认）或 `url`；兼容旧 `MINIMAX_API_RESOURCE_MODE` | | `MINIMAX_JOB_DIR` | 默认 `~/.local/share/hoobnn-minimax-mcp/jobs` | | `MCP_TOOL_GROUPS` | 默认启用 video,image,speech,music,files,jobs,help；取消/删除需显式加入 admin | 配置保留旧四个环境变量即可。任务文件包含素材引用、最终提示词、临时结果 URL 和响应，不包含 API key。恢复锁依赖 POSIX，支持 macOS/Linux。 ## H3 视频 | 工具 | 行为 | |---|---| | `generate_video` | 文生、首帧、尾帧、首尾帧、多模态参考，支持 H3 / H3-Highspeed / H3-Lite / H3-Max | | `create_h3_context_ir_task` | 创建 H3-Context-IR 任务（`/v2/h3_context_ir`），异步生成增强提示词；不自动再提交视频 | | `regenerate_video` | 创建视频再生成任务（`/v2/video_regeneration`），合规的 H3 768P 产物再生成 2K；不是通用超分 | | `query_video_generation` / `get_job` | 查询 V2 任务并交付结果 | | `list_video_tasks` | 分页列出云端最近 7 天任务 | | `delete_video_task` | 取消排队任务或删除已结束任务记录，默认隐藏 | | `upload_file` | 上传生成素材或音色复刻音频，返回 `mm_file://` 引用 | | `list_jobs` / `recover_job` | 本地任务发现及交付恢复，不重新生成 | `MiniMax-H3` 支持 768P / 2K、4–15 整数秒，默认 2K、5 秒；`MiniMax-H3-Highspeed` 仅支持 768P、4–15 秒；`MiniMax-H3-Lite` 支持 480P / 768P、4–15 秒，默认 768P，多模态参考须显式指定具体 `ratio`（不支持 adaptive）；`MiniMax-H3-Max` 支持 480P / 768P、5–15 秒，默认 768P。后三者均不支持 2K。 ```json {"prompt":"小猫抬…