How do I install the Minimax Understand Image skill?

Run npx skillmds@latest add someant/minimax-understand-image in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Minimax Understand Image safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Minimax Understand Image?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Minimax Understand Image free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Minimax Understand Image?

someant (@someant) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Minimax Understand Image by someant

Name: Minimax Understand Image
Rating: 4.2 (5 reviews)
Author: someant

Minimax Understand Image

Use MiniMax MCP to analyze images, extract text (OCR), identify objects, describe visual content, and answer questions about images. Use when the user wants to understand, describe, or extract information from image files or URLs via MiniMax API.

someant Updated Sep 22, 2026

File contents

MiniMax Image Understanding

通过脚本直接启动 minimax-coding-plan-mcp MCP 服务器并调用 understand_image 工具，使用 MCP stdio 协议通信。

前置条件

安装 uvx（pip install uv 或 brew install uv）
设置环境变量 MINIMAX_API_KEY（从 https://platform.minimaxi.com/subscribe/token-plan 获取）

支持的图片格式

JPEG / JPG、PNG、GIF、WebP
最大文件大小：20MB
支持 HTTP/HTTPS URL 或本地绝对路径

使用方法

使用脚本 scripts/understand_image.py 直接通过 stdio 调用 MCP 工具：

MINIMAX_API_KEY=your_api_key python3 scripts/understand_image.py "prompt" "image_url_or_path"

示例

# 描述图片内容
python3 scripts/understand_image.py "详细描述这张图片" "https://example.com/photo.jpg"

# 本地图片 OCR
python3 scripts/understand_image.py "提取图片中的所有文字" "/Users/me/screenshot.png"

# 分析图表
python3 scripts/understand_image.py "这个图表展示了什么趋势？" "/tmp/chart.png"

# 分析代码截图
python3 scripts/understand_image.py "找出代码中的潜在问题" "/path/to/code_screenshot.png"

# 分析 UI 设计
python3 scripts/understand_image.py "描述界面布局并提出改进建议" "https://example.com/ui.png"

工具参数

参数	类型	必填	说明
`prompt`	string	是	对图片的问题或分析需求，越具体越准确
`image_source`	string	是	图片 HTTP/HTTPS URL 或本地绝对文件路径

工作原理

脚本会：

以子进程方式启动 uvx minimax-coding-plan-mcp -y
通过 stdio 发送 MCP JSON-RPC 协议消息（initialize → tools/call）
解析响应并输出图片分析结果
完成后终止子进程

在 Claude Code 中调用

让 Claude 通过 Bash 运行脚本：

python3 /path/to/minimax-understand-image/scripts/understand_image.py "prompt" "image_url"

确保 MINIMAX_API_KEY 已在当前 shell 环境中设置。

---name: minimax-understand-imagedescription: Use MiniMax MCP to analyze images, extract text (OCR), identify objects, describe visual content, and answer questions about images. Use when the user wants to understand, describe, or extract information from image files or URLs via MiniMax API.---# MiniMax Image Understanding通过脚本直接启动 `minimax-coding-plan-mcp` MCP 服务器并调用 `understand_image` 工具，使用 MCP stdio 协议通信。## 前置条件- 安装 `uvx`（`pip install uv` 或 `brew install uv`）- 设置环境变量 `MINIMAX_API_KEY`（从 https://platform.minimaxi.com/subscribe/token-plan 获取）## 支持的图片格式- JPEG / JPG、PNG、GIF、WebP- 最大文件大小：20MB- 支持 HTTP/HTTPS URL 或本地绝对路径## 使用方法使用脚本 `scripts/understand_image.py` 直接通过 stdio 调用 MCP 工具：```bashMINIMAX_API_KEY=your_api_key python3 scripts/understand_image.py "prompt" "image_url_or_path"```## 示例```bash# 描述图片内容python3 scripts/understand_image.py "详细描述这张图片" "https://example.com/photo.jpg"# 本地图片 OCRpython3 scripts/understand_image.py "提取图片中的所有文字" "/Users/me/screenshot.png"# 分析图表python3 scripts/understand_image.py "这个图表展示了什么趋势？" "/tmp/chart.png"# 分析代码截图python3 scripts/understand_image.py "找出代码中的潜在问题" "/path/to/code_screenshot.png"# 分析 UI 设计python3 scripts/understand_image.py "描述界面布局并提出改进建议" "https://example.com/ui.png"```## 工具参数| 参数 | 类型 | 必填 | 说明 || ----------- | ------ | ---- | --------------------------------------- || `prompt` | string | 是 | 对图片的问题或分析需求，越具体越准确 || `image_source` | string | 是 | 图片 HTTP/HTTPS URL 或本地绝对文件路径 |## 工作原理脚本会：1. 以子进程方式启动 `uvx minimax-coding-plan-mcp -y`2. 通过 stdio 发送 MCP JSON-RPC 协议消息（initialize → tools/call）3. 解析响应并输出图片分析结果4. 完成后终止子进程## 在 Claude Code 中调用让 Claude 通过 Bash 运行脚本：```bashpython3 /path/to/minimax-understand-image/scripts/understand_image.py "prompt" "image_url"```确保 `MINIMAX_API_KEY` 已在当前 shell 环境中设置。

Frequently asked questions