Skip to content

README-CN.md

Latest commit

 

History

History
144 lines (113 loc) · 9.98 KB

README-CN.md

File metadata and controls

144 lines (113 loc) · 9.98 KB

export

English Version

专为 coding-plan 用户设计的 MiniMax 模型上下文协议(MCP)服务器，提供针对代码开发工作流优化的AI搜索和视觉分析API。与标准的 MiniMax-MCP 不同，此版本提供专门的编程工具（例如web_search 和 understand_image），可无缝集成到 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等 MCP 客户端，以增强您的编码体验。

Documentation

快速开始使用 MCP 客户端

  1. 从MiniMax国内开放平台｜MiniMax国际开放平台获取你的 API 密钥。
  2. 安装uv（Python包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或查看uv 仓库获取其他安装方法。
  3. 重要提示: API的服务器地址和密钥在不同区域有所不同，两者需要匹配，否则会有 invalid api key 的错误
地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

Claude Desktop

前往Claude > Settings > Developer > Edit Config > claude_desktop_config.json包含以下内容：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-coding-plan-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "填写你的API密钥",
        "MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io"
      }
    }
  }
}

⚠️ 注意：API Key需要与Host匹配。如果出现"API Error: invalid api key"错误，请检查您的API Host：

  • 国际版Host：https://api.minimax.io
  • 国内版Host：https://api.minimaxi.com

如果你使用Windows，你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help"，然后选择"Enable Developer Mode"。

Cursor

前往Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server添加上述配置。

你的MCP客户端现在可以通过Claude Desktop和Cursor等这些工具与MiniMax交互：

Transport

我们支持两种传输方式: stdio and sse.

stdio SSE
在本地部署运行 本地或云端部署均可
通过 stdout 进行通信 通过网络通信
输入：支持处理本地文件，或有效的URL资源 输入: 若部署在云端，建议使用URL进行输入

可用方法

方法 描述
web_search 执行网络搜索并返回有机搜索结果以及相关搜索查询
understand_image 基于文本提示使用AI分析图像，提取信息并回答关于图像的问题

更新日志

2025年11月20日

🆕 新增功能

  • 网络搜索: 新增 web_search 工具 - 执行网络搜索并获取有机搜索结果及相关搜索查询
  • 视觉语言模型: 新增 understand_image 工具 - 基于文本提示使用AI分析图像

📈 功能特性

  • web_search - 搜索网络并获取结构化结果，包括标题、链接、摘要和相关搜索
  • understand_image - 分析来自URL或本地文件的图像，支持JPEG、PNG和WebP格式

FAQ

1. invalid api key

请检查你获取的 API Key 和填写的 API Host 是否是同一地区的：

地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

2. spawn uvx ENOENT

请在你的终端输入一下命令，查看uvx命令的绝对路径：

which uvx

如果得到如下的输出 (如：/usr/local/bin/uvx)，更新mcp配置 ("command": "/usr/local/bin/uvx").

使用示例

⚠️ 注意：使用这些工具可能会产生费用。

1. 网络搜索

使用 web_search 工具在网络上搜索信息：

2. 图像分析

使用 understand_image 工具通过AI分析图像：