vision-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.
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.
Related MCP server: VisionPower
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 understandingFeatures
Tool | Description |
| General image understanding |
| Analyze image from URL |
| OCR - extract text from screenshots |
| Analyze error screenshots, suggest fixes |
| Architecture/flow/UML diagram analysis |
| Chart and data visualization analysis |
Supported Vision APIs
Provider | Model | API Base | Cost |
OpenCode Zen (MiMo-V2.5) |
|
| Free |
Zhipu (GLM-4V) |
|
| Paid |
Qwen-VL (via proxy) |
| Your proxy URL | Varies |
OpenAI |
|
| 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 install2. Configure
cp local/.env.example local/.env
# Edit local/.env, fill in your API key and modelMinimal 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-free3. 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 |
| API key (required) | - |
| API endpoint |
|
| Model name |
|
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-freeGet 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-4vVISION_API_KEY=your-proxy-key
VISION_API_BASE=http://192.168.x.x:8317/v1
VISION_MODEL=Qwen3-VL-msVISION_API_KEY=your-openai-api-key
VISION_API_BASE=https://api.openai.com/v1
VISION_MODEL=gpt-4oUsage
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 templateLicense
MIT License - See LICENSE
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Image & PDF tools for AI agents: compress, convert, resize, PDF, AI vision, pipeline.
PDF, image, video, OCR, screenshot, SQL, QR and text tools for agents. No API key, no signup.
Give your agent eyes: screenshots of any web page it can see, pages as markdown, and PDFs.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to analyze images, extract text, compare images, and analyze video through any OpenAI-compatible vision model.4488 npm20MIT
- AlicenseAqualityDmaintenanceVisionPower enables AI agents to analyze images, read text from screenshots, and interpret charts using any OpenAI-compatible vision model. It supports local images, URLs, base64, and multiple images with order preservation.13MIT
- AlicenseAqualityCmaintenanceEnables AI agents to analyze images via user-configured cloud vision APIs (Gemini or OpenAI-compatible), returning structured results such as summaries, OCR text, and objects.41MIT
- AlicenseAqualityDmaintenanceVision MCP enables text-only agents to understand images through any OpenAI-compatible vision model. It supports local images, URLs, screenshots, documents, charts, and code errors with tools like analyze_image and understand_image.2MIT