MiniMax MCP

MiniMax MCP

MiniMax MCP 是 MiniMax 官方的模型上下文协议 (MCP) 服务器，使 AI 应用能够原生访问强大的语音、图像和视频生成 API。它与流行的 MCP 客户端（如 Claude Desktop 和 Cursor）无缝集成，使基于 LLM 的代理能够执行广泛的多媒体任务——包括文本转音频、语音克隆、图像和视频生成——在一个标准化、可扩展的工作流程中。

Author: MiniMax-AI


查看协议

什么是 MiniMax MCP

MiniMax MCP 是一个 MCP 服务器的实现，为 MCP 客户端提供高质量的文本转语音、语音克隆、图像和视频生成能力。遵循开放的 MCP 规范，它允许任何合规的 LLM 前端或代理框架通过统一协议利用 MiniMax 的多模态 API，支持本地和云集成。

如何配置 MiniMax MCP

  1. 从 MiniMax 平台获取 API 密钥和主机 URL（选择合适的区域：全球或大陆）。
  2. 使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装所需的 Python 包管理器 uv。
  3. 编辑您的客户端配置（例如，在 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 MCP 设置中），为 MiniMax MCP 添加新的 MCP 服务器条目。
    • 将 "command" 设置为 "uvx" 或 uvx 的绝对路径。
    • 添加您的 MINIMAX_API_KEY 和相关的 MINIMAX_API_HOST 环境变量。
    • 可选地设置输出基本路径和资源模式以处理本地/URL 文件。
  4. 对于使用 Claude Desktop 的 Windows 用户，启用开发者模式以激活自定义 MCP 服务器。
  5. 保存并重启您的 MCP 客户端以连接并开始使用 MiniMax MCP。

如何使用 MiniMax MCP

配置完成后：

  • 打开您的 MCP 兼容 AI 工具（例如，Claude Desktop、Cursor）。
  • 访问集成 MCP 的操作或工具面板。
  • 通过提供必要的提示或文件，调用诸如 text_to_audio、text_to_image 或 generate_video 等工具。
  • 对于异步操作（如视频），使用提供的端点和工具函数来监控或检索结果。
  • 根据您是使用 stdio 还是 SSE（网络）传输，调整本地/云文件处理。
  • 查看 API 响应或输出，这些内容可以保存到指定目录或通过 URL 访问。

主要特点

  • 通过开放的 MCP 协议与顶级 AI 工具直接即插即用集成。
  • 支持多模态，包含实时文本转语音、高保真语音克隆和高级文本转图像/视频生成。
  • 灵活的传输选项：本地（stdio）或基于云（SSE）。
  • 通过 MCP 端点自动资源发现和标准工具调用。
  • 通过支持区域密钥分离和本地/URL 基于资源处理的安全数据访问。
  • 可扩展到未来的 MiniMax 生成模式和工具。

使用案例

  • 从 LLM 创建的脚本自动生成高质量的新闻播报音频。
  • 克隆特定声音，并为个性化 AI 虚拟形象合成该风格的音频。
  • 在 AI 工作流程中即时生成并插入图像或视频场景，例如用于演示文稿构建或编码辅助。
  • 将 MiniMax MCP 与下游工具（如 Claude、Cursor）结合，执行混合文本、代码、可视化和音频生成的复杂代理任务。
  • 创建合成训练数据、个性化媒体，或在创意和企业场景中自动化内容管道。

常见问题

1. 如何解决 '无效的 API 密钥' 错误？ 确保您的 API 密钥与您所在地区的正确 API 主机匹配（全球: https://api.minimaxi.chat，大陆: https://api.minimax.chat）。从正确的 MiniMax 用户中心获取您的密钥并仔细检查主机的拼写。

2. 启动服务器时出现 'spawn uvx ENOENT' 错误，我该怎么办？ 确保 uvx 可执行文件在您的系统路径中可用，或在您的配置中指定其绝对路径。您可以使用 which uvx 查找它。

3. 为什么我不能在 Windows 上的 Claude Desktop 中使用 MiniMax MCP 工具？ 您必须在 Claude Desktop 中启用开发者模式（从帮助菜单中）以允许第三方 MCP 服务器。

4. 为什么视频生成请求没有完成？ 视频生成可能是异步的；在您的 IDE 中定义完成规则或使用 query_video_generation 工具检查视频生成任务的状态。

5. 使用这些工具是否会产生成本？ 是的，使用 MultiMax MCP 的 API（文本转语音、视频/图像生成等）在 MiniMax 平台上会产生费用。请参见您的帐户仪表板以获取定价信息。