MiniMax MCP Skill
Overview
Official MiniMax Model Context Protocol (MCP) server for coding-plan users, providing AI-powered search and vision analysis capabilities.
Features
| Tool | Function | Supported Formats |
|---|
| websearch | Web search with structured results (title, link, snippet) | - |
| understandimage |
AI image analysis and content recognition | JPEG, PNG, WebP |
Trigger Scenarios
Use this skill when user says:
- - "Search for xxx" / "Look up xxx"
- "Look at this image" / "Analyze this picture"
- "What's in this image" / "Describe this photo"
- "Extract content from URL" / "Fetch this webpage"
Quick Start
1. Get API Key
| Region | API Key URL | API Host |
|---|
| 🇨🇳 China | platform.minimaxi.com | https://api.minimaxi.com |
| 🇺🇳 Global |
minimax.io | https://api.minimax.io |
2. Configure mcporter (Recommended)
CODEBLOCK0
3. Direct Usage
CODEBLOCK1
Usage Examples
See references/examples.md
Environment Variables
| Variable | Required | Description |
|---|
| INLINECODE0 | ✅ | Your MiniMax API Key |
| INLINECODE1 |
✅ | API endpoint |
Important Notes
⚠️ API Key must match the host region!
| Region | API Key Source | API Host |
|---|
| Global | minimax.io | https://api.minimax.io |
| China |
minimaxi.com | https://api.minimaxi.com |
If you get "Invalid API key" error, check if your Key and Host are from the same region.
Troubleshooting
- - "uvx not found": Install uv -
brew install uv or INLINECODE3 - "Invalid API key": Confirm API Key and Host are from the same region
- Image download failed: Ensure image URL is publicly accessible, supports JPEG/PNG/WebP
Related Resources
- - GitHub: https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP
- MiniMax Platform: https://platform.minimaxi.com (China) / https://www.minimax.io (Global)
MiniMax MCP 技能
概述
面向编码计划用户的官方MiniMax模型上下文协议（MCP）服务器，提供AI驱动的搜索和视觉分析能力。
功能特性
| 工具 | 功能 | 支持的格式 |
|---|
| websearch | 结构化结果（标题、链接、摘要）的网页搜索 | - |
| understandimage |
AI图像分析与内容识别 | JPEG、PNG、WebP |
触发场景
当用户说出以下内容时使用此技能：
- - 搜索xxx / 查找xxx
- 看这张图片 / 分析这张照片
- 这张图片里有什么 / 描述这张照片
- 从URL提取内容 / 获取这个网页
快速开始
1. 获取API密钥
| 区域 | API密钥地址 | API主机 |
|---|
| 🇨🇳 中国 | platform.minimaxi.com | https://api.minimaxi.com |
| 🇺🇳 全球 |
minimax.io | https://api.minimax.io |
2. 配置mcporter（推荐）
bash
添加MCP服务器
mcporter config add minimax \
--command uvx minimax-coding-plan-mcp -y \
--env MINIMAX
APIKEY=your-key \
--env MINIMAX
APIHOST=https://api.minimaxi.com
测试连接
mcporter list
3. 直接使用
bash
搜索
mcporter call minimax.web_search query=关键词
分析图片
mcporter call minimax.understand
image prompt=描述这张图片 imagesource=图片地址或路径
使用示例
参见 references/examples.md
环境变量
| 变量 | 必需 | 描述 |
|---|
| MINIMAXAPIKEY | ✅ | 您的MiniMax API密钥 |
| MINIMAXAPIHOST |
✅ | API端点 |
重要提示
⚠️ API密钥必须与主机区域匹配！
| 区域 | API密钥来源 | API主机 |
|---|
| 全球 | minimax.io | https://api.minimax.io |
| 中国 |
minimaxi.com | https://api.minimaxi.com |
如果收到无效API密钥错误，请检查您的密钥和主机是否来自同一区域。
故障排除
- - uvx not found：安装uv - brew install uv 或 curl -LsSf https://astral.sh/uv/install.sh | sh
- Invalid API key：确认API密钥和主机来自同一区域
- 图片下载失败：确保图片URL可公开访问，支持JPEG/PNG/WebP格式
相关资源
- - GitHub：https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP
- MiniMax平台：https://platform.minimaxi.com（中国）/ https://www.minimax.io（全球）
