项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1597
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 一个支持 MCP 的客户端(如 Claude Desktop、Cursor、Windsurf、OpenAI Agents)
- uv(Python 包管理器),README 提供的安装方式为 curl 脚本
- MiniMax API Key(按区域从 MiniMax 平台用户中心获取)
- 与 API Key 区域匹配的 MINIMAX_API_HOST
安装与启动步骤
-
1获取 API Key
前往 MiniMax 平台用户中心的接口密钥页面获取 API Key;注意全球版与国内版站点不同,Key 与 Host 必须同区域。
-
2安装 uv
README 推荐先安装 uv 作为 Python 包管理器,通过官方脚本一键安装;也可参考 uv 仓库中的其他安装方式。
curl -LsSf https://astral.sh/uv/install.sh | sh -
3确认区域匹配
MINIMAX_API_KEY 和 MINIMAX_API_HOST 必须成对同区域,否则会报 Invalid API key 错误。
-
4设置环境变量
按区域导出两个环境变量:全球版用 api.minimax.io,国内版用 api.minimaxi.com;Key 换成你自己的真实值。
export MINIMAX_API_KEY=sk-xxxxxxxx export MINIMAX_API_HOST=https://api.minimax.io -
5接入 MCP 客户端
在 Claude Desktop、Cursor、Windsurf 等 MCP 客户端中添加 MiniMax MCP 服务器配置,并把上面两个环境变量传入该服务器。
-
6调用生成工具
在客户端中调用文本转语音、文生图、图生视频、文生视频等工具;使用 generate_video 异步模式前需先定义完成规则。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
MINIMAX_API_KEY | 是 | MiniMax 平台接口密钥,区分全球版与国内版 | sk-xxxxxxxx |
MINIMAX_API_HOST | 是 | API 主机地址,必须与 API Key 区域一致 | https://api.minimax.io |
MINIMAX_API_HOST(国内版) | 否 | 国内区域使用的 API 主机地址 | https://api.minimaxi.com |
如何确认成功
MCP 客户端中 MiniMax 服务器连接成功且能列出相关生成工具,调用时不出现 Invalid API key 报错。
常见问题
Q:报 Invalid API key 怎么办?
A:先检查 API Key 与 API Host 是否在同一区域:全球版用 https://api.minimax.io,国内版用 https://api.minimaxi.com,两者错配会直接报错。
Q:使用这些工具要收费吗?
A:README 明确警告:使用这些工具可能产生费用,请自行评估调用量。
Q:没有 uv 可以装吗?
A:README 的 Quickstart 要求先安装 uv,可用 curl -LsSf https://astral.sh/uv/install.sh | sh,或参考 uv 仓库的其他安装方式。
Q:generate_video 异步模式有什么额外要求?
A:需要在开始前定义完成规则,这些规则也可以在 IDE 设置(例如 Cursor)中配置。
注意事项
- README 警告:调用这些生成工具可能产生费用。
- API Key 与 API Host 必须区域匹配,否则会报 Invalid API key。
- README 推荐使用官方 MCP 客户端接入方式(Claude Desktop、Cursor、Windsurf、OpenAI Agents 等)。
- 本次节选未包含完整的客户端 JSON 配置示例,具体配置字段请以仓库 README 最新内容为准。
核心亮点
- 官方出品,API 稳定性和模型质量有保障
- 覆盖 TTS、文生图、图生视频、文生视频,一个 MCP 服务器全搞定
- 安装简单,配置 API 密钥即可在 Claude/Cursor 等 MCP 客户端直接使用
不足之处
- 依赖 MiniMax 云服务,离线或私有化部署受限
- 文档/社区待观察,示例和最佳实践尚不丰富
适用场景
- 在聊天机器人中直接生成语音回复或播报
- 在创意工具中快速生成配图或短视频素材
- 在自动化流程中批量生成多模态内容用于营销或教育
替代项目
OpenAI MCP Servers、Stability AI MCP、Replicate MCP
下一篇:Stellar-Chat
同类项目推荐
burp-ai-agent
开源
在 Burp Suite 里直接调用 AI,自动分析流量、发现漏洞,省时省力。
Burp Suite extension that adds built-in MCP tooling, AI-assisted analysis, privacy c···
gemini-youtube-automation
开源
一键生成教育视频并自动发布到 YouTube,实现全流程无人值守。
A fully autonomous AI Agent/Python pipeline that utilizes Large Language Models (LLM···
cetus
开源
一个 App 管好所有 AI 编程代理,定时跑、快速开、隔离审查。
One macOS app for Claude Code, Codex, and every agent runtime you use — scheduled r···
portable-hermes-agent
开源
免安装免Docker,Windows上跑起本地AI代理,开箱即用
Hermes Agent made portable desktop for Windows — 100 tools, GUI, local models via L···
pr-review-agent-council
开源
让多个AI辩论式审查PR,生成结构化报告并自动评估。
学习 learn-claude-code 后的 PR Review Agent 实践项目:构建 Debate Council 多 Agent 审···
hearth
开源
让 AI 智能体直接参与游戏开发,快速构建 2D 游戏。
Hearth: an open-source, agent-native desktop app for agentic game development.
lanhu-mcp
开源
设计稿一键变代码,AI 编程效率翻倍
⚡ 需求分析效率提升 200%!全球首个为 AI 编程时代设计的团队协作 MCP 服务器,自动分析需···
PrismerCloud
开源
让多个AI智能体共享记忆、协同通信,告别信息孤岛。
Prismer Cloud
youclaw
开源
让 AI 记住你、会技能、定时干活,成为真正的私人助理
Free AI PPT Templates — 4,000+ AI-generated presentation templates for any deck. Wo···
