关键词

文本转语音语音克隆视频生成图像生成MiniMax API

使用说明

项目简介

MiniMax MCP Server 是 MiniMax 官方提供的 Model Context Protocol (MCP) 服务器实现。它允许 MCP 客户端（例如 Claude Desktop、Cursor 等）通过标准化的 MCP 协议调用 MiniMax 平台提供的强大 API 能力，包括：

  • 文本转语音 (Text-to-Speech)：将文本转换为自然流畅的语音，支持多种音色、语速、音调和情感。
  • 语音克隆 (Voice Cloning)：使用上传的音频文件克隆指定的声音，并用于文本转语音。
  • 视频生成 (Video Generation)：根据文本提示或首帧图像生成视频内容。
  • 图像生成 (Image Generation)：根据文本提示生成高质量的图像。

通过 MiniMax MCP Server，用户可以在支持 MCP 协议的客户端中无缝集成 MiniMax 的各项能力，扩展 LLM 应用的功能边界。

主要功能点

  • 资源管理 (Resources)：虽然仓库信息中没有明确提及资源管理，但作为 MCP 服务器，它能够管理和提供对 MiniMax API 功能的访问，这些 API 功能可以被视为一种云端资源。
  • 工具注册和执行 (Tools)：仓库实现了多个工具 (tools)，包括 'text_to_audio'（文本转语音）、'list_voices'（列出可用声音）、'voice_clone'（语音克隆）、'generate_video'（视频生成）和 'text_to_image'（图像生成）。这些工具可以通过 MCP 协议被客户端调用执行。
  • Prompt 模板 (Prompts)：仓库本身没有直接定义 Prompt 模板，但其提供的工具为 LLM 应用提供了丰富的上下文功能，可以与 Prompt 模板结合使用，实现更复杂的交互模式。
  • JSON-RPC 通信：基于 'fastmcp' 库构建，使用 JSON-RPC 协议与客户端进行通信。
  • 会话管理和能力声明：MCP 服务器具备会话管理和能力声明的基础，虽然在代码中没有显式体现会话管理，但 'fastmcp' 框架会处理底层的 MCP 协议细节，包含会话和能力声明。

安装步骤

  1. 获取 API Key：访问 MiniMax 平台 获取您的 API Key。
  2. 安装 'uv'：按照 uv 仓库 的指引安装 'uv' 包管理器。推荐使用命令 'curl -LsSf https://astral.sh/uv/install.sh | sh' 进行安装。
  3. 克隆仓库：将 MiniMax-MCP 仓库克隆到本地。 
    git clone https://github.com/MiniMax-AI/MiniMax-MCP.git
cd MiniMax-MCP
  4. 安装依赖：使用 'uv' 安装项目依赖。 
    uv pip install .
    或者使用 pip 安装： 
    pip install .
  5. 配置环境变量：

    • 创建 '.env' 文件，或直接设置环境变量。

    • 添加以下环境变量，并将 '<your-api-key>' 替换为您在 MiniMax 平台获取的 API Key。您可以选择性配置 'MINIMAX_MCP_BASE_PATH' 指定本地输出目录，以及 'MINIMAX_API_HOST' 指定 API Host（通常无需修改）。

      MINIMAX_API_KEY=<your-api-key>
MINIMAX_MCP_BASE_PATH= # 可选，本地输出目录路径
MINIMAX_API_HOST=https://api.minimaxi.chat # 通常无需修改

服务器配置

以下是在 MCP 客户端（如 Claude Desktop、Cursor）中配置 MiniMax MCP Server 的示例配置信息 (JSON 格式)。您需要将此配置添加到 MCP 客户端的配置文件中，以便客户端能够连接到 MiniMax MCP Server 并调用其提供的工具。

Claude Desktop 配置示例 (claude_desktop_config.json):

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",  // 启动命令，如果使用 pip 安装，则可能是 python 或 python3，取决于您的 Python 环境配置
      "args": [          // 命令参数，指向 minimax-mcp 入口
        "minimax-mcp"
      ],
      "env": {           // 环境变量，传递 API Key 和其他配置
        "MINIMAX_API_KEY": "<insert-your-api-key-here>", // 替换为您的 MiniMax API Key
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path>", // 可选，本地输出目录路径
        "MINIMAX_API_HOST": "https://api.minimaxi.chat" // 通常无需修改
      }
    }
  }
}

Cursor 配置示例 (MCP Server 设置): 在 Cursor 的设置中，选择 "MCP"，然后点击 "Add new global MCP Server"，填入与 Claude Desktop 类似的配置信息。

注意:

  • 'command' 和 'args' 需要根据您的实际 Python 环境和安装方式进行调整。如果使用 'uv pip install .' 安装，且 'uvx' 可执行，则可以使用 '"command": "uvx", "args": ["minimax-mcp"]'。如果直接使用 'pip install .' 安装，则 'command' 可能是您的 Python 解释器路径，'args' 指向 'minimax_mcp/server.py' 文件。
  • 请确保在 MCP 客户端中正确配置了 MiniMax MCP Server 的启动命令和参数，以便客户端能够成功连接并使用 MiniMax 提供的各项功能。

基本使用方法

  1. 启动 MiniMax MCP Server：在命令行中，进入 'MiniMax-MCP' 仓库目录，运行以下命令启动服务器： 
    uvx minimax-mcp # 如果使用 uv 安装
# 或
python -m minimax_mcp.server # 如果直接运行 server.py
    或者根据您的实际安装情况，运行在 MCP 客户端配置中设置的 'command' 和 'args'。
  2. 配置 MCP 客户端：将上述提供的 Claude Desktop 或 Cursor 配置示例添加到您的 MCP 客户端配置文件中，并确保 API Key 等信息正确填写。
  3. 在 MCP 客户端中使用工具：在 MCP 客户端中，您可以像使用普通功能一样调用 MiniMax MCP Server 提供的工具，例如：
    • 在 Claude Desktop 中，您可以要求 Claude "使用 MiniMax 的文本转语音工具将 '你好世界' 转换为语音并播放"。
    • 在 Cursor 中，您可以在代码编辑过程中，利用 MiniMax 的图像生成工具生成代码相关的素材图片。

具体工具的使用方法和参数，请参考 'minimax_mcp/server.py' 文件中每个 '@mcp.tool' 装饰器下的 'description' 字段，其中详细描述了工具的功能、参数和使用说明。

示例用法 (参考 README 图片)

  • 广播晚间新闻片段 (文本转语音)
  • 克隆声音 (语音克隆)
  • 生成视频 (视频生成)
  • 生成图像 (图像生成)

请注意，使用带有 "COST WARNING" 标记的工具可能会产生费用，请谨慎使用。

信息

分类

AI与计算

访问项目