MiniMax MCP Server 配置教程

人工智能学习 网站经验
📅 2026-03-16 14:18 👤 admin

# MiniMax MCP Server 配置教程

本教程将指导你如何在 Cline 中配置 MiniMax MCP Server,让 AI 能够使用 MiniMax 的能力(如图片理解、代码辅助等)。

## 前置要求

1. **Cline 扩展** - 已安装 Cline (Claude Dev) 扩展
2. **MiniMax API Key** - 需要从 [MiniMax 开放平台](https://platform.minimaxi.com) 获取
3. **uvx 工具** - 需要安装 uvx (通常随 uv 一起安装)

## 配置步骤

### 步骤 1: 获取 MiniMax API Key

1. 访问 [MiniMax 开放平台](https://platform.minimaxi.com)
2. 注册/登录账号
3. 在控制台创建 API Key
4. 复制保存好你的 API Key(注意保密)

### 步骤 2: 编辑 MCP 配置文件

Cline 的 MCP 配置文件位于:
```
C:\Users\【你的用户名】\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
```

用文本编辑器打开该文件,添加以下内容:

```json
{
  "mcpServers": {
    "MiniMax": {
      "command": "C:\\Users\\【你的用户名】\\.local\\bin\\uvx.exe",
      "args": [
        "minimax-coding-plan-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "你的API Key填在这里",
        "MINIMAX_MCP_BASE_PATH": "C:\\Users\\【你的用户名】\\.uvx\\minimax-coding-plan-mcp",
        "MINIMAX_API_HOST": "https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "url"
      },
      "autoApprove": [
        "understand_image"
      ]
    }
  }
}
```

### 步骤 3: 重启 Cline

修改配置后,需要重启 Cline 使配置生效:
1. 关闭 VS Code
2. 重新打开 VS Code

或者在 Cline 设置中刷新 MCP Server 连接。

## 配置说明

| 配置项 | 说明 |
|--------|------|
| `command` | 执行命令的路径 |
| `args` | 传递给命令的参数 |
| `env.MINIMAX_API_KEY` | 你的 MiniMax API Key |
| `env.MINIMAX_API_HOST` | API 服务器地址 |
| `autoApprove` | 自动批准的工具列表 |

## 可用功能

配置完成后,你可以使用以下功能:

### 1. 图片理解 (understand_image)
- 分析图片内容
- 提取图片中的文字信息
- 识别图表、数据等

**示例用法:**
```
"请分析这张图片的内容"
"图片中有什么文字信息?"
```

### 2. 其他能力
根据 `minimax-coding-plan-mcp` 的实现,还可能支持:
- 文本生成
- 代码辅助
- 对话交互

## 常见问题

### Q: 为什么 MCP Server 显示未连接?
A: 检查以下几点:
1. uvx 是否正确安装(尝试运行 `uvx --version`)
2. API Key 是否正确
3. 网络是否能访问 api.minimaxi.com

### Q: 如何更新 API Key?
A: 直接修改配置文件中的 `MINIMAX_API_KEY` 值,然后重启 Cline。

### Q: 可以同时使用多个 MCP Server 吗?
A: 可以,在 `mcpServers` 对象中添加多个 Server 配置即可。

## 配置文件位置汇总

- **Windows**: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
- **Mac**: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`

## 安全注意事项

1. **不要分享你的 API Key** - 这是你的私人凭证
2. **不要将配置文件提交到 Git** - 建议将 API Key 添加到环境变量
3. **定期检查使用量** - 在 MiniMax 控制台查看 API 调用统计

---

*配置教程创建时间: 2026-03-16*