MCP 服务器

MiniMax Vision MCP Server

MCP server for MiniMax vision models, enabling image analysis through the OpenAI-compatible chat completions endpoint. Supports local image files and remote URLs, with configurable temperature, max tokens, and adaptive thinking.

README

MiniMax Vision MCP Server

MCP server for MiniMax vision models — analyze images through the OpenAI-compatible POST /v1/chat/completions endpoint.

Features

🖼️ Analyze images — local files (png/jpg/jpeg/gif/webp/bmp) and remote HTTP(S) URLs
🧠 MiniMax-M3: image + video understanding, 1M context, adaptive thinking
🎛️ temperature fully configurable [0, 2] (unlike some providers that lock it)
💭 thinking flag → enables adaptive thinking + reasoning_split on M3
⚡ Zero non-MCP dependencies, one-line npx deploy

Requirements

Node.js >= 18
A MiniMax platform API key (账户管理 → 接口密钥)

Install & run

cd minimax-vision-mcp-server
npm install
npm start

Environment variables

Variable	Required	Default	Description
`MINIMAX_API_KEY`	✅	—	Your MiniMax API key.
`MINIMAX_MODEL`		`MiniMax-M3`	Model: `MiniMax-M3`, `MiniMax-M2.7`, `MiniMax-M2.7-highspeed`, `MiniMax-M2.5`, `MiniMax-M2.5-highspeed`, `MiniMax-M2.1`, `MiniMax-M2.1-highspeed`, `MiniMax-M2`.
`MINIMAX_BASE_URL`		`https://api.minimax.chat/v1`	Override endpoint (for proxies).
`MINIMAX_MAX_TOKENS`		`8192`	Default max output tokens. M3 supports up to 524288.

Note: International users may use https://api.minimaxi.com/v1 as the base URL.

Claude Code / CC-Switch config

{
  "mcpServers": {
    "minimax-vision": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "minimax-vision-mcp-server"],
      "env": {
        "MINIMAX_API_KEY": "your-minimax-api-key",
        "MINIMAX_MODEL": "MiniMax-M3"
      }
    }
  }
}

Tool: `minimax_vision_understand`

Parameter	Type	Required	Description
`image`	string	✅	Local image path or remote HTTP(S) URL.
`prompt`	string	✅	What to ask about the image.
`max_tokens`	number		Max output tokens. Default 8192.
`temperature`	number		0-2, default 1.
`thinking`	bool		Enable adaptive thinking + reasoning split (M3). M2.x always think; ignored there.

Why MiniMax for vision?

1M context on M3 — analyze long documents alongside images
Native image + video understanding
Configurable temperature — fine-grained control over determinism
Adaptive thinking — reasoning on by default, splittable via reasoning_split