vision-mcp

A plain-text model that can see images. Just copy and paste a screenshot—no need to save files or fill in gateways.

Default vision: Groq free qwen/qwen3.6-27b.

Installation

cd D:\workplace\vision
python -m venv .venv
.venv\Scripts\pip install -e .
.venv\Scripts\python -m vision_mcp setup --key gsk_你的key

Free key: https://console.groq.com/keys

setup will:

• Write the key to %USERPROFILE%\.vision-mcp\config.json (not into mcp.json)

• Automatically connect to existing Command Code / Grok / OpenCode / Cursor / Claude on this machine

• Install the vision-see skill

Then restart the corresponding agent, or use /mcp to reconnect in Command Code.

Related MCP server: Vision MCP Server

Toggle

.venv\Scripts\python -m vision_mcp disable
.venv\Scripts\python -m vision_mcp enable
.venv\Scripts\python -m vision_mcp status

Use disable when not needed. In Command Code, you can also disconnect via /mcp in the session without deleting the configuration.

Usage

1. Copy a screenshot (Win+Shift+S)

2. Tell the agent: look at this image / what's the error in the clipboard

3. The agent calls vision_see, which reads the clipboard by default

[Image 1] is treated as clipboard content, not a file path.

Tools

Change Model

Only modify %USERPROFILE%\.vision-mcp\config.json or set an environment variable. No need to touch the MCP configuration.

{
  "api_key": "gsk_...",
  "model": "qwen-vl-max",
  "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1"
}

Manual Configuration

If setup has already been run, there's no need to paste it again. The format is the same as Command Code:

{
  "mcpServers": {
    "vision": {
      "transport": "stdio",
      "enabled": true,
      "command": "D:\\workplace\\vision\\.venv\\Scripts\\python.exe",
      "args": ["-m", "vision_mcp"]
    }
  }
}

Do not write the key into this file.