项目介绍

<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 客户端
- 从 MiniMax 获取您的 API 密钥。
- 安装
uv(Python 包管理器),通过 curl -LsSf https://astral.sh/uv/install.sh | sh 或参阅 uv 仓库 获取更多安装方法。
- 重要:API 主机和密钥因地区而异,必须匹配;否则,您会遇到“无效 API 密钥”错误。
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。
| 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 格式
常见问题解答
1. 无效 API 密钥
请确保您的 API 密钥和 API 主机是区域对齐的
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; "/>