Command Palette

Search for a command to run...

UnylyUnyly
Browse all

HydroCoder Vision

FreeNot checked

A local vision-language MCP server that enables Claude Code to perform image analysis, OCR, and UI-to-code generation using the Qwen3 VL 4B model via LM Studio.

GitHubEmbed

About

A local vision-language MCP server that enables Claude Code to perform image analysis, OCR, and UI-to-code generation using the Qwen3 VL 4B model via LM Studio. It provides privacy-focused visual processing by running entirely on the user's local hardware without external API dependencies.

README

English Installation | 中文安装 | 中文 README

A vision-language MCP server that enables Claude Code to analyze images using Qwen3 VL 4B model running locally via LM Studio.

Features

  • 🔍 Image Analysis - Describe images in detail
  • 📝 Text Extraction (OCR) - Extract text from images in multiple languages
  • 💻 UI to Code - Generate HTML/CSS/JS code from UI/design screenshots
  • 🏠 100% Local - All processing happens on your machine, no cloud API needed
  • Fast - Qwen3 VL 4B runs efficiently on 8GB VRAM

Prerequisites

  1. LM Studio installed and running
  2. Qwen3 VL 4B model loaded in LM Studio
  3. Node.js 18+

Installation

1. Clone the repository

git clone https://github.com/hydroCoderClaud/mcp-hydrocoder-vision.git
cd mcp-hydrocoder-vision

2. Install dependencies

npm install

3. Build the project

npm run build

Configuration

1. Start LM Studio

  1. Open LM Studio
  2. Download and load Qwen3-VL-4B-Instruct model
  3. Start the local server (default: http://localhost:1234)

2. Configure Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "hydrocoder-vision": {
      "command": "npx",
      "args": ["-y", "mcp-hydrocoder-vision"],
      "env": {
        "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
        "VISION_MODEL": "Qwen3-VL-4B-Instruct"
      }
    }
  }
}

Usage

Available Tools

analyzeImage

Analyze an image and get a detailed description.

/analyzeImage imagePath: "C:/path/to/image.png" prompt: "What's in this image?"

extractText

Extract text from an image (OCR).

/extractText imagePath: "C:/path/to/document.png" language: "English"

describeForCode

Generate code from a UI/design screenshot.

/describeForCode imagePath: "C:/path/to/design.png" framework: "Vue"

Environment Variables

Variable Default Description
LM_STUDIO_URL http://localhost:1234/v1/chat/completions LM Studio API endpoint
VISION_MODEL Qwen3-VL-4B-Instruct Model name to use

Development

# Run in development mode (watch mode)
npm run dev

# Build for production
npm run build

# Start the built server
npm start

Troubleshooting

"Request failed: ECONNREFUSED"

  • Make sure LM Studio is running
  • Check that the local server is enabled
  • Verify the LM_STUDIO_URL is correct

"No response from model"

  • Ensure Qwen3 VL 4B model is loaded in LM Studio
  • Check LM Studio logs for errors
  • Try a simpler prompt first

Image not found

  • Use absolute paths
  • Ensure the file exists and is accessible
  • Check file permissions

License

MIT

from github.com/hydroCoderClaud/mcp-hydrocoder-vision

Install HydroCoder Vision in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install mcp-hydrocoder-vision

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 mcp-hydrocoder-vision -- npx -y mcp-hydrocoder-vision

Step-by-step: how to install HydroCoder Vision

FAQ

Is HydroCoder Vision MCP free?

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

Does HydroCoder Vision need an API key?

No, HydroCoder Vision runs without API keys or environment variables.

Is HydroCoder Vision hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

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

Open HydroCoder Vision 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

Compare HydroCoder Vision with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs