MiniMax-MCP

把 MiniMax 的语音/图像/视频生成能力一键接入你的 AI 工作流

MiniMax-MCP 是 MiniMax 官方推出的 Model Context Protocol (MCP) 服务器,旨在将 MiniMax 的多模态生成能力无缝接入支持 MCP 的 AI 应用(如 Claude、Cursor 等)。它解决了开发者在现有 AI 工作流中调用高质量语音、图像和视频生成 API 的集成难题,提供统一的 MCP 工具接口。核心能力包括:文本转语音(TTS)、文本生成图像、图像生成视频、文本生成视频等,覆盖从创意构思到多媒体内容产出的完整链路。通过标准化的 MCP 协议,开发者无需编写复杂集成代码,即可在聊天界面或智能体中直接触发多媒体生成任务,大幅降低多模态 AI 应用的门槛。项目基于 Python 实现,安装配置简单,适合快速原型开发和产品落地。

开源 pay_as_you_go 图像生成
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1585
维护状态 维护中
是否开源 是
定价模式 pay_as_you_go

项目数据

分类图像生成
开发团队MiniMax-AI
所属国家
定价模式pay_as_you_go
价格说明通过MCP服务器调用MiniMax的TTS、图像生成和视频生成API,按API调用量计费,具体价格需查看官网。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型image-generation,image-to-video,mcp,mcp-server,mcp-tools,text-to-image,text-to-speech,text-to-video,video-generation,voice-cloning
GitHub 星标★ 1585
30天Star增速
HF 下载量
上线时间2025-04-10 00:00:00
最近更新2026-09-19 00:00:00
维护状态维护中
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 6 步

环境要求

  • 一个支持 MCP 的客户端(如 Claude Desktop、Cursor、Windsurf、OpenAI Agents)
  • uv(Python 包管理器),README 提供的安装方式为 curl 脚本
  • MiniMax API Key(按区域从 MiniMax 平台用户中心获取)
  • 与 API Key 区域匹配的 MINIMAX_API_HOST

安装与启动步骤

  1. 1获取 API Key

    前往 MiniMax 平台用户中心的接口密钥页面获取 API Key;注意全球版与国内版站点不同,Key 与 Host 必须同区域。

  2. 2安装 uv

    README 推荐先安装 uv 作为 Python 包管理器,通过官方脚本一键安装;也可参考 uv 仓库中的其他安装方式。

    curl -LsSf https://astral.sh/uv/install.sh | sh
  3. 3确认区域匹配

    MINIMAX_API_KEY 和 MINIMAX_API_HOST 必须成对同区域,否则会报 Invalid API key 错误。

  4. 4设置环境变量

    按区域导出两个环境变量:全球版用 api.minimax.io,国内版用 api.minimaxi.com;Key 换成你自己的真实值。

    export MINIMAX_API_KEY=sk-xxxxxxxx
    export MINIMAX_API_HOST=https://api.minimax.io
  5. 5接入 MCP 客户端

    在 Claude Desktop、Cursor、Windsurf 等 MCP 客户端中添加 MiniMax MCP 服务器配置,并把上面两个环境变量传入该服务器。

  6. 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

项目介绍

MiniMax-MCP 是智能体领域的开源项目,由 MiniMax-AI 开发,2025 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,585)位列前 30%,在智能体分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,555 增加到 1,585,净增 30。

项目仍在小幅维护中,最近一次代码更新于 2026-09-19。通过MCP服务器调用MiniMax的TTS、图像生成和视频生成API,按API调用量计费,具体价格需查看官网。从国内网络环境看,可直接访问。

它主要面向的使用场景是:在聊天机器人中直接生成语音回复或播报。同类可对比的替代方案包括 OpenAI MCP Servers、Stability AI MCP、Replicate MCP。

上一篇:ai-sdk-deep-research

下一篇:Stellar-Chat

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12