使用说明

项目简介

Minimax MCP 工具集是一个实现了 Model Context Protocol (MCP) 协议的服务器，它集成了 Minimax 平台的 API，为 LLM 客户端（如 Windsurf 和 Cursor 编辑器）提供强大的图像生成和文本转语音功能。通过此 MCP 服务器，你可以方便地在支持 MCP 协议的编辑器中使用 Minimax 的 AI 能力。

主要功能点

图像生成: 根据文本描述，使用 Minimax 的 'image-01' 模型生成高质量图像。支持自定义图片比例、生成数量，并可指定保存路径。
文本转语音 (TTS): 将文本转换为自然流畅的语音。支持丰富的语音模型选择，包括多种音色、情感和语速等参数调节。同时支持多种音频格式输出，并可选择生成字幕文件。

安装步骤

安装 Node.js: 确保你的系统已安装 Node.js 16 或更高版本。
获取 Minimax API 密钥和 Group ID: 访问 Minimax 平台获取 API 密钥 (MINIMAX_API_KEY) 和用于 TTS 功能的 Group ID (MINIMAX_GROUP_ID)。
下载仓库代码: 克隆或下载此 GitHub 仓库的代码到本地。
安装依赖: 在仓库根目录下，打开终端并运行 'npm install' 命令安装项目依赖。

服务器配置

MCP 服务器需要配置到 MCP 客户端（如 Windsurf 或 Cursor 编辑器）中才能使用。以下是配置示例，你需要根据你的实际情况修改 'env' 中的 API 密钥和 Group ID。

Windsurf 配置 ( '~/.codeium/windsurf/mcp_config.json' ) 或 Cursor 配置 ('~/.cursor/config/mcp_config.json') 示例:

{
  "mcpServers": {
    "minimax-mcp-tools": {
      "command": "npx",  // 启动命令，使用 npx 运行 npm 包
      "args": [          // 启动参数，这里指定运行 minimax-mcp-tools 包
        "minimax-mcp-tools"
      ],
      "env": {           // 环境变量配置
        "MINIMAX_API_KEY": "your-minimax-api-key",      // 替换为你的 Minimax API 密钥
        "MINIMAX_GROUP_ID": "your-minimax-group-id"    // 替换为你的 Minimax Group ID (TTS功能需要)
      }
    }
  }
}

配置说明:

'"mcpServers"': 定义 MCP 服务器列表。
'"minimax-mcp-tools"': 服务器名称，可以自定义，在客户端中用于标识和选择此服务器。
'"command"': 启动服务器的命令，这里使用 'npx' 来运行安装在 'node_modules/.bin' 目录下的可执行文件。
'"args"': 传递给 'command' 的参数，这里指定运行 'minimax-mcp-tools' 包。
'"env"': 设置环境变量，用于配置 Minimax API 密钥和 Group ID。请务必替换 'your-minimax-api-key' 和 'your-minimax-group-id' 为你自己的密钥和 Group ID。

基本使用方法

配置完成后，在 Windsurf 或 Cursor 编辑器中，你可以通过 MCP 协议调用以下工具：

'generate_image' (图像生成工具):
- 提供 'prompt' 参数 (文本描述) 来生成图像。
- 可选参数包括 'aspectRatio' (图片比例), 'n' (生成数量), 'outputFile' (指定保存路径)。
'generate_speech' (文本转语音工具):
- 提供 'text' 参数 (要转换的文本) 来生成语音。
- 支持丰富的可选参数，包括 'model' (语音模型), 'voiceId' (音色), 'speed' (语速), 'emotion' (情感), 'format' (音频格式), 'outputFile' (指定保存路径) 等。

具体工具的使用方法和参数可以在支持 MCP 协议的编辑器中查看工具的详细描述。

启动服务器: 无需手动启动服务器，MCP 客户端 (如 Windsurf 或 Cursor) 会根据配置在需要时自动启动该 MCP 服务器。

关键词