{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zwcsp4kdeaxd","handle":"hoobnn-minimax-mcp","url":"https://wellknown.network/agents/hoobnn-minimax-mcp","links":{"self":"https://wellknown.network/agents/hoobnn-minimax-mcp/record.json","html":"https://wellknown.network/agents/hoobnn-minimax-mcp","markdown":"https://wellknown.network/agents/hoobnn-minimax-mcp/record.md","api":"https://wellknown.network/api/v1/agents/hoobnn-minimax-mcp","status":"https://wellknown.network/api/v1/agents/hoobnn-minimax-mcp/status","claim":"https://wellknown.network/agents/hoobnn-minimax-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hoobnn-minimax-mcp/claim.json","badge":"https://wellknown.network/agents/hoobnn-minimax-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hoobnn-minimax-mcp/history","tools":"https://wellknown.network/api/v1/agents/hoobnn-minimax-mcp/tools"},"ard":{"identifier":"urn:air::server:hoobnn-minimax-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hoobnn-minimax-mcp","summary":"MiniMax H3 video, speech, image and music MCP with durable task recovery","description":"# MiniMax MCP\n\n独立重写的 MiniMax stdio MCP，重点支持 H3 V2。包名 `hoobnn-minimax-mcp`，不是官方 `minimax-mcp`，不依赖后者。沿用本仓库的连接池、超时取消、任务持久化与交付恢复机制。\n\n`0.3.0` 的 `generate_video` 新增 `MiniMax-H3-Highspeed`（仅 768P）与 `MiniMax-H3-Lite`（480P / 768P，多模态参考需显式指定具体 `ratio`），均为 4–15 秒、不支持 2K。\n\n`0.2.0` 将 `enhance_video_prompt` 更名为 `create_h3_context_ir_task`，与官方「创建 H3-Context-IR 任务」对应；旧名不保留别名，这是不兼容变更。\n\n## 安装与迁移\n\n从 PyPI 安装：\n\n```bash\nuv tool install hoobnn-minimax-mcp\n```\n\n本地开发可在仓库根目录运行 `uv tool install ./servers/minimax`。\n\n客户端命令改为 `~/.local/bin/hoobnn-minimax-mcp` 的绝对路径，不带参数。原来的 `uvx minimax-mcp -y` 启动的是官方包，单纯升级它不会获得本实现。需要重启 MCP 客户端后才会发现新工具。\n\n| 环境变量 | 用途 |\n|---|---|\n| `MINIMAX_API_KEY` | 必填，与 API 区域匹配；不写入任务记录 |\n| `MINIMAX_API_HOST` | 默认 `https://api.minimax.cn`；也接受已有的 `https://api.minimaxi.com` 或国际站 `https://api.minimax.io` |\n| `MINIMAX_OUT_DIR` | 默认 `~/Downloads/minimax`，兼容旧 `MINIMAX_MCP_BASE_PATH` |\n| `MINIMAX_RESOURCE_MODE` | `local`（默认）或 `url`；兼容旧 `MINIMAX_API_RESOURCE_MODE` |\n| `MINIMAX_JOB_DIR` | 默认 `~/.local/share/hoobnn-minimax-mcp/jobs` |\n| `MCP_TOOL_GROUPS` | 默认启用 video,image,speech,music,files,jobs,help；取消/删除需显式加入 admin |\n\n配置保留旧四个环境变量即可。任务文件包含素材引用、最终提示词、临时结果 URL 和响应，不包含 API key。恢复锁依赖 POSIX，支持 macOS/Linux。\n\n## H3 视频\n\n| 工具 | 行为 |\n|---|---|\n| `generate_video` | 文生、首帧、尾帧、首尾帧、多模态参考，支持 H3 / H3-Highspeed / H3-Lite / H3-Max |\n| `create_h3_context_ir_task` | 创建 H3-Context-IR 任务（`/v2/h3_context_ir`），异步生成增强提示词；不自动再提交视频 |\n| `regenerate_video` | 创建视频再生成任务（`/v2/video_regeneration`），合规的 H3 768P 产物再生成 2K；不是通用超分 |\n| `query_video_generation` / `get_job` | 查询 V2 任务并交付结果 |\n| `list_video_tasks` | 分页列出云端最近 7 天任务 |\n| `delete_video_task` | 取消排队任务或删除已结束任务记录，默认隐藏 |\n| `upload_file` | 上传生成素材或音色复刻音频，返回 `mm_file://` 引用 |\n| `list_jobs` / `recover_job` | 本地任务发现及交付恢复，不重新生成 |\n\n`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。\n\n```json\n{\"prompt\":\"小猫抬…","publisher":{"name":"hoobnn","url":null},"homepage":null,"repository":"https://github.com/hoobnn/hoobnn-mcps","version":"0.3.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:hoobnn-minimax-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.video-generation","name":"Video Generation","confidence":0.917,"provenance":"derived"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"hoobnn-minimax-mcp","registry":"pypi","observedAt":"2026-10-24T17:29:04.869Z","publishedAt":"2026-10-24T16:00:28.252134Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hoobnn-minimax-mcp","url":"https://pypi.org/project/hoobnn-minimax-mcp/","firstSeenAt":"2026-10-12T14:24:42.791Z","fetchedAt":"2026-10-24T17:27:36.571Z","normalizedAt":"2026-10-24T17:27:36.571Z"}]},"firstSeenAt":"2026-10-12T14:24:42.791Z","updatedAt":"2026-10-24T17:29:04.869Z"}