How do I use vision-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vision-mcp Extract text from screenshot.png" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

vision-mcp

by knownothing20

Overview Schema Related Servers Score Discussions

JavaScript

vision-mcp

Vision MCP Server for AI Agents - give your text-only model eyes.

Use any OpenAI-compatible vision model API through MCP tools for image analysis, OCR, error diagnosis, diagram understanding, and chart analysis.

License: MIT Version

中文文档

One-line Summary

Give AI Agents visual understanding through MCP tools. Works with any OpenAI-compatible vision API (GLM-4V, Qwen-VL, MiMo-V2.5, GPT-4o, etc.).

Analogy: Vision MCP is the eyes for text-only models like GLM-5.1.

Architecture

User sends image path or URL
  -> AI Agent (text model, e.g. GLM-5.1)
  -> vision-mcp tools (MCP)
  -> Vision Model API (e.g. MiMo-V2.5-Free, Qwen3-VL, GLM-4V)
  -> Returns text description
  -> AI Agent continues with understanding

Features

Tool	Description
`image_analysis`	General image understanding
`image_analysis_url`	Analyze image from URL
`extract_text`	OCR - extract text from screenshots
`diagnose_error`	Analyze error screenshots, suggest fixes
`understand_diagram`	Architecture/flow/UML diagram analysis
`analyze_chart`	Chart and data visualization analysis

Supported Vision APIs

Provider	Model	API Base	Cost
OpenCode Zen (MiMo-V2.5)	`mimo-v2.5-free`	`https://opencode.ai/zen/v1`	Free
Zhipu (GLM-4V)	`glm-4v`	`https://open.bigmodel.cn/api/paas/v4`	Paid
Qwen-VL (via proxy)	`Qwen3-VL-ms`	Your proxy URL	Varies
OpenAI	`gpt-4o`	`https://api.openai.com/v1`	Paid
Any OpenAI-compatible	Custom	Custom	Varies

MiMo-V2.5 is a native omnimodal model by Xiaomi that supports text, image, video, and audio. The free tier on OpenCode Zen is a great starting point.

Quick Start

1. Clone

git clone https://github.com/knownothing20/vision-mcp.git
cd vision-mcp
npm install

2. Configure

cp local/.env.example local/.env
# Edit local/.env, fill in your API key and model

Minimal config for MiMo-V2.5 Free (OpenCode Zen):

VISION_API_KEY=your-opencode-zen-api-key
VISION_API_BASE=https://opencode.ai/zen/v1
VISION_MODEL=mimo-v2.5-free

3. Register in opencode

Add to opencode.json (replace path with your actual skill dir):

{
  "mcp": {
    "vision-mcp": {
      "command": ["node", "/path/to/vision-mcp/index.js"],
      "enabled": true,
      "type": "local"
    }
  }
}

Or use node sync.cjs to auto-register (recommended).

4. Restart opencode

Restart your AI tool to activate MCP registration.

Configuration

Edit local/.env:

Variable	Description	Default
`VISION_API_KEY`	API key (required)	-
`VISION_API_BASE`	API endpoint	`https://open.bigmodel.cn/api/paas/v4`
`VISION_MODEL`	Model name	`glm-4v`

Priority: local/.env > .env (root) > environment variables.

Provider Examples

VISION_API_KEY=sk-your-zen-api-key
VISION_API_BASE=https://opencode.ai/zen/v1
VISION_MODEL=mimo-v2.5-free

Get your API key at https://opencode.ai/auth

VISION_API_KEY=your-zhipu-api-key
VISION_API_BASE=https://open.bigmodel.cn/api/paas/v4
VISION_MODEL=glm-4v

VISION_API_KEY=your-proxy-key
VISION_API_BASE=http://192.168.x.x:8317/v1
VISION_MODEL=Qwen3-VL-ms

VISION_API_KEY=your-openai-api-key
VISION_API_BASE=https://api.openai.com/v1
VISION_MODEL=gpt-4o

Usage

After setup, provide image file paths to your AI agent:

"Analyze this image: C:\Users\you\Desktop\screenshot.png"
"Extract text from /path/to/document.png"
"Diagnose this error: C:\screenshots\error.png"
"What does this architecture diagram mean? /path/to/diagram.png"
"Analyze chart trends: /path/to/chart.png"

Note: Your main AI model (e.g. GLM-5.1) may not support image input directly. Provide the file path instead of embedding the image in chat, and the agent will use vision-mcp tools to analyze it.

Directory Structure

vision-mcp/
├── index.js              # MCP server main program
├── sync.cjs              # Repo <-> skill dir sync tool
├── package.json          # Dependencies
├── SKILL.md              # Agent documentation
├── README.md             # This file
├── README_CN.md          # Chinese documentation
├── AGENT_GUIDE.md        # Agent install guide
├── INSTALL_OTHER_MACHINE.md  # Install on another machine
├── CHANGELOG.md          # Version changelog
├── LICENSE               # MIT License
├── .gitignore
└── local/                # Local private config (gitignored)
    └── .env.example      # Config template

License

MIT License - See LICENSE

This server cannot be installed

license - not tested

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/knownothing20/vision-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server