MCP OpenVision

@Nazruden

Repository

Basic information

About MCP OpenVision

MCP Server using OpenRouter models to get descriptions for images

#mcp-openvision#image-analysis #ai-assistant

MCP OpenVision config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-openvision": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Nazruden/mcp-openvision",
        "--client",
        "claude"
      ]
    }
  }
}

MCP OpenVision tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP OpenVision?

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 through a simple interface within the MCP ecosystem.

How to use MCP OpenVision?

Install via pip install mcp-openvision or uv pip install mcp-openvision, or use Smithery for automatic integration with Claude Desktop. Configure by setting the OPENROUTER_API_KEY environment variable (required) and optionally OPENROUTER_DEFAULT_MODEL. Add the server to your MCP configuration file (e.g., mcp.json for Claude Desktop or Cursor) with the command uvx mcp-openvision and your API key. Test with npx @modelcontextprotocol/inspector uvx mcp-openvision.

Key features of MCP OpenVision

Single image_analysis tool accepting images as base64, URL, or file path.
Supports customizable system prompt, model, temperature, and max_tokens.
Works with any OpenRouter model that supports vision capabilities.
Default model is qwen/qwen2.5-vl-32b-instruct:free.
Can use relative file paths with an optional project_root parameter.
Integrates seamlessly with Claude Desktop and Cursor via MCP configuration.

Use cases of MCP OpenVision

Analyze store shelf images to identify retail products and estimate price ranges.
Examine medical scans for abnormalities and possible diagnoses.
Extract numerical data from charts and identify trends over time.
Transcribe text from menus, signs, or documents preserving structure.
Provide detailed art historical analysis of paintings focusing on composition and technique.

Frequently asked questions

What is required to use MCP OpenVision?

You need an OpenRouter API key and a Python environment (pip or uv). The server itself runs as an MCP tool and requires no additional services beyond OpenRouter.

What vision models are supported?

Any OpenRouter model that supports vision capabilities. The default is `qwen/qwen2.5-vl-32b-instruct:free`, but you can change it via the `OPENROUTER_DEFAULT_MODEL` environment variable or by passing the `model` parameter directly.

How can I provide images to the tool?

Images can be given as base64‑encoded strings, HTTP/HTTPS URLs, or local file paths (absolute or relative). When using relative paths, you can specify a `project_root` to resolve them against a specific directory.

How do I integrate MCP OpenVision with Claude Desktop?

Edit your MCP configuration file (e.g., `~/.cursor/mcp.json` or `~/Library/Application Support/Claude/claude_desktop_config.json`) and add the `openvision` server entry with command `uvx mcp-openvision` and your `OPENROUTER_API_KEY` environment variable.

Is there a way to test the server without a full MCP client?

Yes. Use the MCP Inspector tool by running `npx @modelcontextprotocol/inspector uvx mcp-openvision`. This will launch an interactive test interface.

Comments

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea