Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Vison

FreeNot checked

MCP server for vision AI — screenshots to code, OCR, error diagnosis, and image analysis via OpenAI-compatible APIs.

Lin-zhiboby Lin-zhibo
GitHubEmbed

About

MCP server for vision AI — screenshots to code, OCR, error diagnosis, and image analysis via OpenAI-compatible APIs.

README

MCP server for vision AI — screenshots to code, OCR, error diagnosis, and image analysis via OpenAI-compatible APIs.

Supported Tools

Tool Description
image_analysis General visual understanding — describe any image in detail
extract_text_from_screenshot OCR optimized for terminals, code, documents, and general content
ui_to_artifact Convert UI screenshots into code, prompts, specs, or descriptions
diagnose_error_screenshot Analyze error screenshots and propose actionable fixes
understand_technical_diagram Interpret architecture diagrams, flowcharts, UML, ER, and system diagrams
analyze_data_visualization Read charts and dashboards to surface insights, trends, and anomalies
ui_diff_check Compare two UI screenshots to flag visual differences and implementation drift
video_analysis Inspect videos (MP4/MOV/M4V) — scene detection, event analysis, content summarization

Installation

git clone https://github.com/Lin-zhibo/Vison-MCP.git
cd Vison-MCP
npm install
npm run build

Configuration

Set the following environment variables:

Variable Required Default Description
VISIONAI_API_KEY Yes — API authentication key
VISIONAI_BASE_URL Yes — OpenAI-compatible API endpoint
VISIONAI_MODEL_NAME No gpt-4o Vision model to use

Usage

With Claude Code

Add to your .claude/settings.json or claude_desktop_config.json:

{
  "mcpServers": {
    "vison-mcp": {
      "command": "node",
      "args": ["/path/to/Vison-MCP/dist/index.js"],
      "env": {
        "VISIONAI_API_KEY": "your-api-key",
        "VISIONAI_BASE_URL": "https://api.openai.com/v1",
        "VISIONAI_MODEL_NAME": "gpt-4o"
      }
    }
  }
}

Local Development

# Copy environment template
cp .env.example .env
# Edit .env with your API credentials

# Build and run
npm run build
npm start

Requirements

  • Node.js >= 18.0.0
  • An OpenAI-compatible vision API endpoint (GPT-4o, Claude Vision, or compatible)

License

MIT

from github.com/Lin-zhibo/Vison-MCP

Install Vison in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install vison-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add vison-mcp -- npx -y github:Lin-zhibo/Vison-MCP

FAQ

Is Vison MCP free?

Yes, Vison MCP is free — one-click install via Unyly at no cost.

Does Vison need an API key?

No, Vison runs without API keys or environment variables.

Is Vison hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Vison in Claude Desktop, Claude Code or Cursor?

Open Vison on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

GitHubby GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

mcpdotdirectby mcpdotdirect

Compare Vison with

VisonvsGitHubVisonvsFilesystemVisonvsMemoryVisonvsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs