跳转到主要内容

​
Coding Plan MCP 简介

Coding Plan 是 MiniMax 专为 AI 编码场景提供的订阅计划。Coding Plan MCP 提供了两个专属工具：网络搜索（web_search） 和 图片理解（understand_image），帮助开发者在编码过程中快速获取信息和理解图片内容。

​
Coding Plan MCP 工具清单

web_search

该工具可根据搜索查询词进行网络搜索

understand_image

该工具可对图片进行理解和分析

​
工具与参数详情

该工具可根据搜索查询词进行网络搜索，返回搜索结果和相关搜索建议。
参数含义格式及说明默认值
query必需, 搜索查询词字符串无

​
2. understand_image

该工具可对图片进行理解和分析，支持多种图片输入方式。
参数含义格式及说明默认值
prompt必需, 对图片的提问或分析要求字符串无
image_url必需, 图片的来源字符串, 支持以下两种格式:
1. HTTP/HTTPS URL: 网络图片地址
2. 本地文件路径: 本地图片文件的绝对路径或相对路径		无
图片格式支持:
  • JPEG/JPG
  • PNG
  • GIF
  • WebP
图片大小限制: 最大 20MB

​
在客户端使用 Coding Plan MCP 服务

​
获取 API Key

​
UVX 安装和配置

MiniMax‑Coding-Plan-MCP 是一个 Python 实现的 MCP 服务，为了让 MCP 客户端顺利调用，该服务必须通过 uvx 启动和执行。 uvx 和 uv 提供的命令行工具，类似于 npm exec ，用于运行包内部定义的可执行程序，确保环境隔离与依赖可控。
  1. 安装 uv 以便获取 uvx
    • macOS / Linux 用户：
curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows 用户：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
其他安装方式可参考 uv 仓库。安装完成后，会在 Python 环境的 Scripts 或 bin 目录中生成 uv 和 uvx 可执行文件。
  1. 验证 uvx 是否可用
执行命令：
  • macOS / Linux 用户：
which uvx
  • Windows 用户：
(Get-Command uvx).source
  • 若正确安装，会显示路径（如 /usr/local/bin/uvx ）。
  • 若系统报错 spawn uvx ENOENT ，说明没有安装 uvx 或 uvx 不在系统路径中，需要配置绝对路径。

​
在 Claude Code 中使用

  1. 在 Claude Code 官网下载 Claude Code
  2. 在全局配置文件 ~/.claude.json 中新增以下 json 配置。进入 Claude Code 后输入 /mcp，能看到 web_search 和 understand_image，说明已经配置成功。
{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-coding-plan-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "填写你的API密钥",
        "MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io"
      }
    }
  }
}

​
在 Cursor 中使用

  1. 通过 Cursor 官网 下载并安装 Cursor
  2. 前往 Cursor -> Preferences -> Cursor Settings -> Tools & Integrations -> MCP -> Add Custom MCP ，打开 MCP 工具配置文件
Cursor MCP 配置
  1. 在 mcp.json 文件中，增加 MiniMax 账户配置信息
{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": ["minimax-coding-plan-mcp"],
      "env": {
        "MINIMAX_API_KEY": "填写你的API密钥",
        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，如/User/xxx/Desktop，需要保证路径存在且具有写入权限",
        "MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io",
        "MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url"
      },
      "transport": "可选配置，传输方式，可选项为 [stdio|SSE]，默认为 stdio"
    }
  }
}