vision-mcp
Allows image analysis, comparison, OCR, and scene description using Google Gemini's vision models (e.g., Gemini Pro Vision) via OpenRouter.
Allows image analysis, comparison, OCR, and scene description using locally hosted vision models via Ollama (e.g., LLaVA).
Allows image analysis, comparison, OCR, and scene description using OpenAI's vision models (e.g., GPT-4o).
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-mcpDescribe what's in this image"
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
A Model Context Protocol (MCP) server that provides image analysis capabilities using vision-capable AI models.
Features
Image Analysis: Analyze images for objects, text, colors, and context
Image Comparison: Compare multiple images and identify differences
Text Extraction (OCR): Extract text from images with formatting preservation
Scene Description: Get detailed descriptions of scenes and settings
Related MCP server: vision-mcp-server
Installation
Option 1: Use directly with npx (no install needed)
Add to Claude Desktop config:
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_API_KEY": "your-api-key",
"OPENAI_BASE_URL": "https://api.openai.com/v1",
"VISION_MODEL": "gpt-4o"
}
}
}
}Option 2: Install globally from GitHub
npm install -g github:cpramod/vision-mcpThen use in Claude Desktop config:
{
"mcpServers": {
"vision": {
"command": "vision-mcp",
"env": {
"OPENAI_API_KEY": "your-api-key",
"OPENAI_BASE_URL": "https://api.openai.com/v1",
"VISION_MODEL": "gpt-4o"
}
}
}
}Option 3: Install from local clone
git clone https://github.com/cpramod/vision-mcp.git
cd vision-mcp
npm install
npm run buildThen use the local path in Claude Desktop config:
{
"mcpServers": {
"vision": {
"command": "node",
"args": ["/path/to/vision-mcp/dist/index.js"],
"env": {
"OPENAI_API_KEY": "your-api-key",
"OPENAI_BASE_URL": "https://api.openai.com/v1",
"VISION_MODEL": "gpt-4o"
}
}
}
}Configuration
Environment Variables
Variable | Description | Required |
| API key for the vision provider | For most providers |
| Custom API endpoint URL | No (defaults to OpenAI) |
| Model name to use | No (defaults to |
Usage with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
OpenAI:
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_API_KEY": "your-openai-api-key",
"VISION_MODEL": "gpt-4o"
}
}
}
}Anthropic Claude via OpenRouter:
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_BASE_URL": "https://openrouter.ai/api/v1",
"OPENAI_API_KEY": "your-openrouter-key",
"VISION_MODEL": "anthropic/claude-3.5-sonnet"
}
}
}
}Google Gemini via OpenRouter:
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_BASE_URL": "https://openrouter.ai/api/v1",
"OPENAI_API_KEY": "your-openrouter-key",
"VISION_MODEL": "google/gemini-pro-vision"
}
}
}
}Ollama (local):
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_BASE_URL": "http://localhost:11434/v1",
"VISION_MODEL": "llava"
}
}
}
}Groq:
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_BASE_URL": "https://api.groq.com/openai/v1",
"OPENAI_API_KEY": "your-groq-key",
"VISION_MODEL": "llama-3.2-11b-vision-preview"
}
}
}
}LM Studio (local):
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["github:cpramod/vision-mcp"],
"env": {
"OPENAI_BASE_URL": "http://localhost:1234/v1",
"VISION_MODEL": "local-model"
}
}
}
}Available Tools
analyze_image
Analyze an image using vision AI.
Parameters:
image(required): URL or base64-encoded image dataprompt(optional): Custom analysis promptdetail(optional): "low", "high", or "auto" detail level
Example:
{
"name": "analyze_image",
"arguments": {
"image": "https://example.com/image.jpg",
"prompt": "What's in this image?"
}
}compare_images
Compare 2-4 images.
Parameters:
images(required): Array of image URLs or base64 data (2-4 images)prompt(optional): Custom comparison prompt
extract_text
Extract text from images (OCR).
Parameters:
image(required): URL or base64-encoded imagepreserve_formatting(optional): Maintain layout (default: true)
describe_scene
Get detailed scene descriptions.
Parameters:
image(required): URL or base64-encoded imagefocus(optional): Focus area (e.g., "people", "architecture")
Supported Image Formats
JPEG, PNG, GIF, WebP
URLs or base64-encoded data URIs
Development
npm run dev # Build and run
npm run build # Compile TypeScript
npm start # Run compiled serverPublishing to npm (optional)
npm login
npm publishAfter publishing to npm, users can install with:
{
"mcpServers": {
"vision": {
"command": "npx",
"args": ["vision-mcp"],
"env": {
"OPENAI_API_KEY": "your-api-key",
"OPENAI_BASE_URL": "https://api.openai.com/v1",
"VISION_MODEL": "gpt-4o"
}
}
}
}This server cannot be installed
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/cpramod/vision-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server