Skip to main content
Glama

MiniMax Vision MCP

将 MiniMax VL 多模态能力通过 MCP 暴露给 Claude Code(或其他 MCP 客户端),补足 DeepSeek v4 flash 等非多模态模型的读图能力。

功能

  • understand_image — 分析单张或多张图片,返回文字描述

  • 支持本地文件路径、http(s) URL、base64 data URL

  • 格式:JPEG、PNG、WebP、GIF

  • 支持两种 MiniMax API 模式(通过 MINIMAX_ENDPOINT 切换)

Related MCP server: MCP Image Recognition Server

前置条件

  • Python 3.10+

  • MiniMax API Key(开通了 VL 模型的 token plan)

快速开始

1. 安装

cd ~/Downloads/minimax-vision-mcp
pip install -e .

或用 uv(推荐):

cd ~/Downloads/minimax-vision-mcp
uv pip install -e .

2. 配置 Claude Code

编辑 ~/.claude/settings.local.json(或项目的 .claude/settings.json),添加:

{
  "mcpServers": {
    "minimax-vision": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/wenjiaqi/Downloads/minimax-vision-mcp",
        "minimax-vision-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "your-api-key-here",
        "MINIMAX_ENDPOINT": "chat_completion"
      }
    }
  }
}

Claude Desktop 也兼容:上述 stdio 配置格式可直接用于 claude_desktop_config.json

3. 重启 Claude Code

重启后,在对话中发送图片或图片路径,Claude 会自动调用 understand_image 工具来分析图片。

环境变量

变量

必需

默认值

说明

MINIMAX_API_KEY

MiniMax API 密钥

MINIMAX_API_HOST

https://api.minimax.chat

API 地址(中国区用 https://api.minimaxi.com

MINIMAX_MODEL

minimax-vl-01

VL 模型名(仅 chat_completion 模式)

MINIMAX_ENDPOINT

chat_completion

API 模式:chat_completioncoding_plan

两种 API 模式

chat_completion(默认) 通用 MiniMax VL API,通过 /v1/text/chatcompletion_v2 调用,支持多图、system prompt、temperature 等参数。适用于标准 token plan。

coding_plan MiniMax Coding Plan 专有端点 /v1/coding_plan/vlm,仅支持单图 + prompt。如果你是 Coding Plan 用户可用此模式。

不确定用哪个? 先试试 chat_completion(默认)。如果返回 404 或 auth 错误,切到 coding_plan

使用示例

# 分析本地图片
understand_image(
    prompt="这张图片里有什么?请详细描述。",
    image_path="/Users/wenjiaqi/Downloads/photo.png"
)

# 分析网络图片
understand_image(
    prompt="Extract text from this image",
    image_url="https://example.com/screenshot.jpg"
)

# 多图对比
understand_image(
    prompt="Compare these two UI designs",
    image_paths=["/path/to/design1.png", "/path/to/design2.png"]
)

项目结构

minimax-vision-mcp/
├── pyproject.toml
├── README.md
└── src/
    └── minimax_vision_mcp/
        ├── __init__.py
        └── server.py          # MCP 服务器主文件

License

MIT

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wenjiaqi8255/minimax-vision-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server