快速开始¶

本指南将引导您完成 MiniMax-MCP 服务器的基本安装和配置。

安装指南¶

获取 API 密钥: 您需要从 MiniMax 平台获取 API 密钥。请根据您所在的区域访问相应的链接：
- 全球区域: MiniMax Global
- 中国大陆区域: MiniMax
安装 uv: MiniMax-MCP 使用 uv 作为 Python 包管理器。如果尚未安装，请使用以下推荐命令安装：
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
更多安装方法请参考 uv 官方仓库。

来源：README.md

MiniMax-MCP 服务器主要通过环境变量进行配置。以下是关键的环境变量：

MINIMAX_API_KEY (必需): 您的 MiniMax API 密钥。
MINIMAX_API_HOST (必需): MiniMax API 的主机地址。请确保此地址与您的 API 密钥所属区域匹配。
MINIMAX_MCP_BASE_PATH (可选): 本地输出目录的路径。当 MINIMAX_API_RESOURCE_MODE 设置为 local 时，生成的资源文件（音频、视频、图像）将存储在此目录下。例如：/Users/your_username/Desktop/mcp_output。
MINIMAX_API_RESOURCE_MODE (可选): 指定资源返回的方式。
- url (默认值): 服务器返回生成资源的公共可访问 URL。
- local: 服务器将资源下载到 MINIMAX_MCP_BASE_PATH 指定的目录，并返回本地文件路径。

重要提示: API 密钥 (MINIMAX_API_KEY) 必须与 API 主机 (MINIMAX_API_HOST) 的区域严格匹配，否则将导致认证失败。

来源：README.md

请务必根据您获取 API 密钥的区域，使用对应的 API 主机地址：

区域	API 密钥来源	API 主机地址
全球 (Global)	MiniMax Global	`https://api.minimaxi.chat` (注意域名中有额外的 "i")
中国大陆	MiniMax	`https://api.minimax.chat`

错误排查: 如果您在配置后遇到 Invalid API key 或 API Error: invalid api key 错误，请首先检查您的 API 密钥和主机地址是否正确匹配了上述区域。

来源：README.md

MiniMax-MCP 服务器通常不直接由最终用户运行，而是通过兼容的 MCP 客户端（如 Claude Desktop, Cursor）进行配置和调用。

客户端会负责启动服务器进程。典型的启动命令如下：

uvx minimax-mcp -y

配置方法请参考客户端集成指南。配置完成后，客户端通常会自动发现 MiniMax-MCP 提供的工具，并允许您在聊天或代码编辑过程中调用它们。

来源：README.md (客户端配置部分)