Vision MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vision MCP Serverextract text from this image: receipt.jpg"
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 Server
Give your AI agent eyes. An MCP server providing multimodal vision capabilities โ image analysis, OCR, image comparison, and video analysis โ powered by any OpenAI-compatible vision model.
่ฎฉไฝ ็ AI ไปฃ็ๆฅๆ่ง่ง่ฝๅใ ้่ฟไปปไฝ OpenAI ๅ ผๅฎน็่ง่งๆจกๅ๏ผๆไพๅพๅๅๆใOCR ๆๅญ่ฏๅซใๅพๅๅฏนๆฏๅ่ง้ขๅๆใ
Features ยท Quick Start ยท Tools ยท Models ยท ไธญๆ่ฏดๆ
โจ Features
Tool | Description |
๐ | Analyze images with natural language prompts |
๐ | Extract text from images (plain text / Markdown / JSON) |
๐ | Compare 2โ4 images side by side |
๐ฌ | Analyze video content (requires video-capable model) |
Plus:
๐ OpenAI-compatible โ Works with any vision model via standard API
๐ Local files & URLs โ Auto-converts local files to base64
โ๏ธ Configurable โ Environment variables, config files, or both
Related MCP server: mcp-see
๐ Quick Start
1. Install
git clone https://github.com/Loveacup/vision-mcp-server.git
cd vision-mcp-server
npm install && npm run build2. Configure
Create a .env file in the project root:
VISION_BASE_URL=http://your-server:port/v1/chat/completions
VISION_MODEL=Qwen3-VL-32B
VISION_API_KEY=your-api-key # optional for local models{
"baseUrl": "http://your-server:port/v1/chat/completions",
"model": "Qwen3-VL-32B",
"apiKey": "your-api-key",
"maxTokens": 4096,
"temperature": 0.7
}3. Run
npm startThe server communicates over stdio, designed to be launched by an MCP client such as Claude Code.
๐ Claude Code Integration
Add to your ~/.mcp.json:
{
"mcpServers": {
"vision": {
"command": "node",
"args": ["/path/to/vision-mcp-server/dist/index.js"],
"env": {
"VISION_BASE_URL": "http://your-server:port/v1/chat/completions",
"VISION_MODEL": "Qwen3-VL-32B",
"VISION_API_KEY": "your-api-key"
}
}
}
}Replace
/path/to/vision-mcp-serverwith the actual install path.
โ๏ธ Configuration Reference
Configuration priority: environment variables > config file > defaults
Variable | Config Key | Default | Description |
|
| (required) | OpenAI-compatible chat completions endpoint |
|
|
| Model name |
|
| (empty) | API key (optional for local models) |
|
|
| Max response tokens |
|
|
| Sampling temperature |
๐ ๏ธ Tools Reference
analyze_image
Analyze an image with a vision language model.
Parameter | Type | Required | Default | Description |
| string | โ | โ | Local file path or URL |
| string |
| Analysis prompt | |
|
|
| Detail level |
ocr_image
Extract text from an image using OCR.
Parameter | Type | Required | Default | Description |
| string | โ | โ | Local file path or URL |
| string |
| Language hint, e.g. | |
|
|
| Output format |
compare_images
Compare 2โ4 images and describe differences/similarities.
Parameter | Type | Required | Default | Description |
| string[] | โ | โ | 2โ4 image sources |
| string |
| Comparison prompt |
analyze_video
Analyze video content. Requires a model with video support (e.g., Qwen3-VL).
Parameter | Type | Required | Default | Description |
| string | โ | โ | Local file path or URL |
| string |
| Analysis prompt |
๐ค Supported Models
Model | Provider | Image | Video | Notes |
Qwen3-VL | Self-hosted / API | โ | โ | Recommended. Full multimodal support |
GPT-4o | OpenAI | โ | โ | Strong image analysis |
LLaVA | Self-hosted | โ | โ | Open-source alternative |
InternVL | Self-hosted | โ | โ ๏ธ | Strong multilingual OCR |
Any model served via vLLM, Ollama, LMDeploy, or other OpenAI-compatible servers should work.
Supported formats: JPEG, PNG, GIF, WebP, BMP, SVG | MP4, AVI, MOV, MKV, WebM
๐ Project Structure
vision-mcp-server/
โโโ src/
โ โโโ index.ts # MCP server entry point
โ โโโ config.ts # Configuration loader
โ โโโ types.ts # TypeScript type definitions
โ โโโ tools/
โ โ โโโ analyze-image.ts
โ โ โโโ ocr-image.ts
โ โ โโโ compare-images.ts
โ โ โโโ analyze-video.ts
โ โโโ utils/
โ โโโ api-client.ts # OpenAI-compatible API client
โ โโโ file-handler.ts # Local file โ base64
โโโ package.json
โโโ tsconfig.json
โโโ .env.example
โโโ LICENSE๐ License
๐จ๐ณ ไธญๆ่ฏดๆ
ๅ่ฝ
analyze_imageโ ไฝฟ็จ่ง่ง่ฏญ่จๆจกๅๅๆๅพๅ๏ผๆฏๆ่ช็ถ่ฏญ่จๆ้ฎocr_imageโ OCR ๆๅญ่ฏๅซ๏ผๆฏๆ็บฏๆๆฌใMarkdownใJSON ่พๅบcompare_imagesโ ๅฏนๆฏ 2โ4 ๅผ ๅพๅ๏ผ่ฏๅซๅทฎๅผๅ็ธไผผไนๅคanalyze_videoโ ๅๆ่ง้ขๅ ๅฎน๏ผ้่ฆ Qwen3-VL ็ญๆฏๆ่ง้ข็ๆจกๅ๏ผ
ๅฟซ้ๅผๅง
git clone https://github.com/Loveacup/vision-mcp-server.git
cd vision-mcp-server
npm install && npm run build้
็ฝฎ .env๏ผ
VISION_BASE_URL=http://your-server:port/v1/chat/completions
VISION_MODEL=Qwen3-VL-32B
VISION_API_KEY=your-api-keyๅจ Claude Code ็ ~/.mcp.json ไธญๆทปๅ ๏ผ
{
"mcpServers": {
"vision": {
"command": "node",
"args": ["/path/to/vision-mcp-server/dist/index.js"],
"env": {
"VISION_BASE_URL": "http://your-server:port/v1/chat/completions",
"VISION_MODEL": "Qwen3-VL-32B",
"VISION_API_KEY": "your-api-key"
}
}
}
}ๅฐ /path/to/vision-mcp-server ๆฟๆขไธบๅฎ้
ๅฎ่ฃ
่ทฏๅพใ
Maintenance
Resources
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 InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/Loveacup/vision-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server