MCP OpenVision
About
MCP Server using OpenRouter models to get descriptions for images
Details
- License
- MIT
Explore
MCP OpenVision provides the following core tool:
- image_analysis: Analyze images with vision models, supporting various parameters:
- image: Can be provided as:
- Base64-encoded image data
- Image URL (http/https)
- Local file path
- query: User instruction for the image analysis task
- system_prompt: Instructions that define the model's role and behavior (optional)
- model: Vision model to use
- temperature: Controls randomness (0.0-1.0)
- max_tokens: Maximum response length
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP OpenVisionCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
MCP OpenVision requires an OpenRouter API key and can be configured through environment variables:
- OPENROUTER_API_KEY (required): Your OpenRouter API key
- OPENROUTER_DEFAULT_MODEL (optional): The vision model to use
To install mcp-openvision for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Nazruden/mcp-openvision --client claude
pip install -e ".[dev]"
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp openvision": {
"mcp-openvision": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@Nazruden/mcp-openvision",
"--client",
"claude"
]
}
}
}
}McpServers
{
"mcp-openvision": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@Nazruden/mcp-openvision",
"--client",
"claude"
]
}
}
Overview
MCP OpenVision is a Model Context Protocol (MCP) server that provides image analysis capabilities powered by OpenRouter vision models. It enables AI assistants to analyze images via a simple interface within the MCP ecosystem.
Installation
Installing via Smithery
To install mcp-openvision for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Nazruden/mcp-openvision --client claude
Using pip
pip install mcp-openvision
Using UV (recommended)
uv pip install mcp-openvision
Configuration
MCP OpenVision requires an OpenRouter API key and can be configured through environment variables:
- OPENROUTER_API_KEY (required): Your OpenRouter API key
- OPENROUTER_DEFAULT_MODEL (optional): The vision model to use
OpenRouter Vision Models
MCP OpenVision works with any OpenRouter model that supports vision capabilities. The default model is qwen/qwen2.5-vl-32b-instruct:free, but you can specify any other compatible model.
Some popular vision models available through OpenRouter include:
- qwen/qwen2.5-vl-32b-instruct:free (default)
- anthropic/claude-3-5-sonnet
- anthropic/claude-3-opus
- anthropic/claude-3-sonnet
- openai/gpt-4o
You can specify custom models by setting the OPENROUTER_DEFAULT_MODEL environment variable or by passing the model parameter directly to the image_analysis function.
Usage
Testing with MCP Inspector
The easiest way to test MCP OpenVision is with the MCP Inspector tool:
npx @modelcontextprotocol/inspector uvx mcp-openvision
Integration with Claude Desktop or Cursor
1. Edit your MCP configuration file:
- Windows: %USERPROFILE%\.cursor\mcp.json
- macOS: ~/.cursor/mcp.json or ~/Library/Application Support/Claude/claude_desktop_config.json
2. Add the following configuration:
{
"mcpServers": {
"openvision": {
"command": "uvx",
"args": ["mcp-openvision"],
"env": {
"OPENROUTER_API_KEY": "your_openrouter_api_key_here",
"OPENROUTER_DEFAULT_MODEL": "anthropic/claude-3-sonnet"
}
}
}
}
Running Locally for Development
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
