Vision MCP Server

Free, unlimited vision capabilities for your AI coding assistant using Groq API and Meta Llama 4 Vision model.

Features

• Image Analysis - Understand and describe images

• Text Extraction (OCR) - Extract text from screenshots, documents, photos

• UI Analysis - Describe UI components, layouts, and design

• Error Diagnosis - Analyze error screenshots and suggest fixes

• Diagram Understanding - Interpret flowcharts, UML, architecture diagrams

• Chart Analysis - Read charts and dashboards for insights

• Image Comparison - Compare two images for differences

• Code Extraction - Extract code from IDE screenshots

Installation

Prerequisites

• Python 3.10 or higher

• Free Groq API key

Get Groq API Key (Free)

1. Visit https://console.groq.com/keys

2. Sign up (free)

3. Create a new API key

Install Dependencies

cd vision-mcp-server

# Option 1: Using install script (recommended)
./install.sh

# Option 2: Manual installation
pip3 install mcp groq pillow aiofiles

Configuration

Claude Desktop

Add to ~/.claude/config.json:

{
  "mcpServers": {
    "vision-mcp-server": {
      "command": "python",
      "args": ["-m", "vision_mcp_server.server"],
      "env": {
        "GROQ_API_KEY": "your-groq-api-key-here"
      }
    }
  }
}

OpenCode

Add to OpenCode settings:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vision-mcp-server": {
      "type": "local",
      "command": ["python", "-m", "vision_mcp_server.server"],
      "environment": {
        "GROQ_API_KEY": "your-groq-api-key-here"
      }
    }
  }
}

Cline (VS Code)

Add to Cline settings:

{
  "mcpServers": {
    "vision-mcp-server": {
      "command": "python",
      "args": ["-m", "vision_mcp_server.server"],
      "env": {
        "GROQ_API_KEY": "your-groq-api-key-here"
      }
    }
  }
}

Usage

Analyze Image

Describe this image: screenshot.png

Extract Text

Extract text from this document: scan.jpg

Diagnose Error

What's wrong with this error screenshot: error.png

Understand Diagram

Explain this architecture diagram: system-diagram.png

Compare Images

Compare these two UI screenshots: old-ui.png vs new-ui.png

Available Tools

• analyze_image - General image analysis

• extract_text - OCR text extraction

• describe_ui - UI component analysis

• diagnose_error - Error screenshot analysis

• understand_diagram - Diagram interpretation

• analyze_chart - Chart and dashboard analysis

• compare_images - Image comparison

• code_from_screenshot - Code extraction from screenshots

Models Used

• meta-llama/llama-4-scout-17b-16e-instruct - Latest Meta Llama 4 vision model

• Available for free via Groq API

• No quotas, no limits

• Superior vision capabilities and multimodal performance

Testing

Run locally:

export GROQ_API_KEY=your-api-key
python -m vision_mcp_server.server

License

MIT