返回市场
极小极大编码计划MCP

极小极大编码计划MCP

作者:MiniMax-AI2 星标更新:2025-11-20

项目介绍

export

<div align="center" style="line-height: 1;"> <a href="https://www.minimax.io" target="_blank" style="margin: 2px; color: var(--fgColor-default);"> <img alt="首页" src="https://img.shields.io/badge/_首页-MiniMax-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://arxiv.org/abs/2501.08313" target="_blank" style="margin: 2px;"> <img alt="论文" src="https://img.shields.io/badge/📖_论文-MiniMax--01-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://chat.minimax.io/" target="_blank" style="margin: 2px;"> <img alt="聊天" src="https://img.shields.io/badge/_MiniMax_聊天-FF4040?style=flat-square&labelColor=2C3E50&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNDkwLjE2IDQxMS43Ij48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZmZjt9PC9zdHlsZT48L2RlZnM+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNMjMzLjQ1LDQwLjgxYTE3LjU1LDE3LjU1LDAsMSwwLTM1LjEsMFYzMzEuNTZhNDAuODIsNDAuODIsMCwwLDEtODEuNjMsMFYxNDVhMTcuNTUsMTcuNTUsMCwxLDAtMzUuMDksMHY3OS4wNmE0MC44Miw0MC44MiwwLDAsMS04MS42MywwVjE5NS40MmExMS42MywxMS42MywwLDAsMSwyMy4yNiwwdjI4LjY2YTE3LjU1LDE3LjU1LDAsMCwwLDM1LjEsMFYxNDVBNDAuODIsNDAuODIsMCwwLDEsMTQwLDE0NVYzMzEuNTZhMTcuNTUsMTcuNTUsMCwwLDAsMzUuMSwwVjIxNy41aDBWNDAuODFhNDAuODEsNDAuODEsMCwxLDEsODEuNjIsMFYyODEuNTZhMTEuNjMsMTEuNjMsMCwxLDEtMjMuMjYsMFptMjE1LjksNjMuNEE0MC44Niw0MC44NiwwLDAsMCw0MDguNTMsMTQ1VjMwMC44NWExNy41NSwxNy41NSwwLDAsMS0zNS4wOSwwdi0yNjBhNDAuODIsNDAuODIsMCwwLDAtODEuNjMsMFYzNzAuODlhMTcuNTUsMTcuNTUsMCwwLDEtMzUuMSwwVjMzMGExMS42MywxMS42MywwLDEsMC0yMy4yNiwwdjQwLjg2YTQwLjgxLDQwLjgxLDAsMCwwLDgxLjYyLDBWNDAuODFhMTcuNTUsMTcuNTUsMCwwLDEsMzUuMSwwdjI2MGE0MC44Miw0MC44MiwwLDAsMCw4MS42MywwVjE0NWExNy41NSwxNy41NSwwLDEsMSwzNS4xLDBWMjgxLjU2YTExLjYzLDExLjYzLDAsMCwwLDIzLjI2LDBWMTQ1QTQwLjg1LDQwLjg1LDAsMCwwLDQ0OS4zNSwxMDQuMjFaIi8+PC9zdmc+&logoWidth=20" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://www.minimax.io/platform" style="margin: 2px;"> <img alt="API" src="https://img.shields.io/badge/⚡_API-平台-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/> </a> </div> <div align="center" style="line-height: 1;"> <a href="https://huggingface.co/MiniMaxAI" target="_blank" style="margin: 2px;"> <img alt="Hugging Face" src="https://img.shields.io/badge/🤗_Hugging_Face-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://github.com/MiniMax-AI/MiniMax-AI.github.io/blob/main/images/wechat-qrcode.jpeg" target="_blank" style="margin: 2px;"> <img alt="微信" src="https://img.shields.io/badge/_微信-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://www.modelscope.cn/organization/MiniMax" target="_blank" style="margin: 2px;"> <img alt="ModelScope" src="https://img.shields.io/badge/_ModelScope-MiniMax-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/> </a> </div> <div align="center" style="line-height: 1;"> <a href="https://github.com/MiniMax-AI/MiniMax-MCP/blob/main/LICENSE" style="margin: 2px;"> <img alt="代码许可" src="https://img.shields.io/badge/_代码许可-MIT-FF4040?style=flat-square&labelColor=2C3E50" style="display: inline-block; vertical-align: middle;"/> </a> </div> <p align="center"> 专为 <a href="https://platform.minimax.io/docs/coding-plan/intro">编码计划</a> 用户设计的 MiniMax 模型上下文协议 (MCP) 服务器,提供优化的搜索和视觉分析 API,适用于代码开发工作流程。与标准的 <a href="https://github.com/MiniMax-AI/MiniMax-MCP">MiniMax-MCP</a> 不同,此版本提供了特定于编码的工具(例如:<code>web_search</code> 和 <code>understand_image</code>),这些工具可以无缝集成到如 <a href="https://www.anthropic.com/claude">Claude Desktop</a>、<a href="https://www.cursor.so">Cursor</a>、<a href="https://codeium.com/windsurf">Windsurf</a>、<a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> 等 MCP 客户端中,以增强您的编码体验。 </p>

文档

快速开始使用 MCP 客户端

  1. MiniMax 获取您的 API 密钥。
  2. 安装 uv(Python 包管理器),通过 curl -LsSf https://astral.sh/uv/install.sh | sh 或参阅 uv 仓库 获取更多安装方法。
  3. 重要:API 主机和密钥因地区而异,必须匹配;否则,您会遇到“无效 API 密钥”错误。
地区全球大陆
MINIMAX_API_KEYMiniMax 全球 获取MiniMax 获取
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 添加以下内容:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-coding-plan-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "在此插入您的 API 密钥",
        "MINIMAX_API_HOST": "API 主机,https://api.minimax.io | https://api.minimaxi.com"
      }
    }
  }
}

⚠️ 警告:API 密钥需要与主机匹配。如果出现“API 错误:无效 API 密钥”的错误,请检查您的 API 主机:

  • 全球主机:https://api.minimax.io
  • 大陆主机:https://api.minimaxi.com

如果您使用的是 Windows,您需要在 Claude Desktop 中启用“开发者模式”。点击左上角的汉堡菜单中的“帮助”,然后选择“启用开发者模式”。

Cursor

前往 Cursor -> 首选项 -> Cursor 设置 -> MCP -> 添加新的全局 MCP 服务器 添加上述配置。

就这样。您的 MCP 客户端现在可以通过这些工具与 MiniMax 进行交互:

传输

我们支持两种传输类型:stdio 和 sse。

stdioSSE
本地运行可以本地或云端部署
通过 stdout 通信通过 网络 通信
输入:支持处理 本地文件 或有效的 URL 资源输入:当部署在云端时,建议使用 URL 作为输入

可用工具

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

发布说明

2025年11月20日

🆕 新增功能

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

📈 功能

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

常见问题解答

1. 无效 API 密钥

请确保您的 API 密钥和 API 主机是区域对齐的

地区全球大陆
MINIMAX_API_KEYMiniMax 全球 获取MiniMax 获取
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. 启动 uvx ENOENT

请通过运行以下命令确认其绝对路径:

which uvx

一旦获得绝对路径(例如,/usr/local/bin/uvx),更新您的配置以使用该路径(例如,“command”: “/usr/local/bin/uvx”)。

示例用法

⚠️ 警告:使用这些工具可能会产生费用。

1. 网络搜索

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

<img src="https://gips2.baidu.com/it/u=320233750,3286243106&fm=3081&app=3081&f=PNG?w=984&h=1374" style="display: inline-block; vertical-align: middle; "/>

2. 图像分析

使用 understand_image 工具使用 AI 分析图像:

<img src="https://gips2.baidu.com/it/u=480873575,3258641083&fm=3081&app=3081&f=PNG?w=978&h=1346" style="display: inline-block; vertical-align: middle; "/>