🔌 MCP 配置

MiniMax Token Plan MCP 指南

图片理解 & 网络搜索 — MiniMax Token Plan 专属 MCP 工具,集成到 Claude Code / Cursor / OpenCode,赋予 AI 编程助手实时网络搜索和图片理解能力。

📡 两个专属工具

Token Plan MCP 提供两个专属工具:网络搜索图片理解,帮助开发者在编码过程中快速获取信息和理解图片内容。

🌐

web_search

根据搜索查询词进行网络搜索,返回搜索结果和相关搜索建议。

querystring搜索查询词
🖼️

understand_image

对图片进行理解和分析,支持多种图片输入方式。

promptstring对图片的提问或分析要求
image_urlstring图片来源,HTTP/HTTPS URL 或本地文件路径,支持 JPEG/PNG/GIF/WebP(最大 20MB)
💡 提示: 推荐使用 MiniMax CLI 替代 MCP,配置更简单、使用更高效。

⚙️ 前置准备

1

获取 API Key

访问 Token Plan 订阅页面,订阅套餐并获取专属 API Key。

2

安装 uvx

uvx 是 uv 工具包管理器的一部分,用于运行 MCP 服务器。

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
3

验证安装

which uvx # macOS/Linux (Get-Command uvx).source # Windows

若正确安装,会显示路径(如 /usr/local/bin/uvx)。若报错 spawn uvx ENOENT,需配置绝对路径。

�难 Claude Code 配置

1

下载 Claude Code

在 Claude Code 官网下载并安装 Claude Code。

2

配置 MCP

一键安装(推荐)或手动配置:

一键安装
手动配置
claude mcp add -s user MiniMax \
  --env MINIMAX_API_KEY=api_key \
  --env MINIMAX_API_HOST=https://api.minimaxi.com \
  -- uvx minimax-coding-plan-mcp -y

将 api_key 替换为您的 API Key,一键自动配置。

3

验证配置

进入 Claude Code 后输入 /mcp,能看到 web_searchunderstand_image,说明配置成功。

⚠️ IDE 用户注意: 在 TRAE 等 IDE 中使用 MCP,还需要在对应 IDE 的 MCP 配置中进行设置。

📁 Cursor 配置

1

下载 Cursor

通过 Cursor 官网下载并安装 Cursor。

2

打开 MCP 配置

前往 Cursor → Preferences → Cursor Settings → Tools & Integrations → MCP → Add Custom MCP

3

添加配置

mcp.json 文件中添加以下配置:

{ "mcpServers": { "MiniMax": { "command": "uvx", "args": ["minimax-coding-plan-mcp"], "env": { "MINIMAX_API_KEY": "填写你的API密钥", "MINIMAX_MCP_BASE_PATH": "本地输出目录路径,需保证路径存在且有写入权限", "MINIMAX_API_HOST": "https://api.minimaxi.com", "MINIMAX_API_RESOURCE_MODE": "可选,资源提供方式:url 或 local,默认 url" } } } }

⚡ OpenCode 配置

1

下载 OpenCode

通过 OpenCode 官网下载并安装 OpenCode。

2

编辑配置

编辑配置文件 ~/.config/opencode/opencode.json,添加 MCP 配置:

{ "$schema": "https://opencode.ai/config.json", "mcp": { "MiniMax": { "type": "local", "command": ["uvx", "minimax-coding-plan-mcp", "-y"], "environment": { "MINIMAX_API_KEY": "MINIMAX_API_KEY", "MINIMAX_API_HOST": "https://api.minimaxi.com" }, "enabled": true } } }
3

验证配置

进入 OpenCode 后,输入 /mcp,能看到 MiniMax connected,说明配置成功。

🔍 MCP vs CLI 对比

对比项 MiniMax CLI MCP
配置复杂度 ✅ 简单,一行命令 ⚙️ 需要手动配置 JSON
使用效率 ✅ 高效 ⚡ 依赖 MCP 协议开销
工具 web_search + understand_image web_search + understand_image
IDE 兼容性 部分支持 ✅ Claude Code / Cursor / OpenCode 等

📝 总结

来源:MiniMax 开放平台 · Token Plan MCP 指南 · platform.minimaxi.com/docs/token-plan/mcp-guide