Vision MCP Server

Ever wanted to use a model like GLM-4.6 or other great AI models that just don’t have vision capabilities? This MCP server solves that problem by adding vision capabilities to any model through OpenRouter’s vision models.

The Problem

Some really good AI models don’t support vision. You’re stuck choosing between your preferred model or vision capabilities. This server bridges that gap by providing seamless vision capabilities through OpenRouter’s vision models.

The Solution

This MCP server provides a simple analyze_image tool that can:

• Analyze images from URLs, file paths, or base64 data
• Use any vision model available on OpenRouter (Claude 3.5 Sonnet, GPT-4 Vision, etc.)
• Return detailed analysis results
• Handle errors gracefully with proper validation

System Requirements

Before installing, make sure you have:

• Node.js 18.0.0 or higher (recommended: Node.js 20+)
• npm 8.0.0 or higher (comes with Node.js)

Check Your Versions

node --version    # Should show v18.0.0 or higher
npm --version     # Should show 8.0.0 or higher

Install/Update Node.js

If you need to install or update Node.js:

1. Download from official site: nodejs.org (recommended for beginners)
2. Using Node Version Manager (nvm):

   # Install nvm first, then:
   nvm install 20
   nvm use 20
   

3. Using package managers:
   • macOS: brew install node
   • Windows: winget install OpenJS.NodeJS
   • Ubuntu/Debian: sudo apt install nodejs npm

Important: This server is written in TypeScript and uses dependencies (like node-fetch v3) that require Node.js 18+. Older versions (like Node.js 16 or below) will not work.

Quick Start

Step 1: Get Your OpenRouter API Key

1. Go to OpenRouter
2. Sign up or log in to your account
3. Navigate to “Keys” in your dashboard
4. Click “Create Key”
5. Copy your API key (starts with sk-or-v1-...)
6. Keep this key safe - you’ll need it in Step 3

Step 2: Install the MCP Server

Option A: Install from npm (Recommended)

npm install -g @thenomadinorbit/vision-mcp-server

Success! The package is now globally available as vision-mcp command.

Option B: Install from Source (Development)

git clone https://github.com/TheNomadInOrbit/vision-mcp-server.git
cd vision-mcp-server
npm install
npm run build
npm install -g .

Note: Use this method if you want to modify the source code or contribute to the project.

Step 3: Configure Your MCP Client

Add this server configuration to your MCP client:

{
  "mcpServers": {
    "vision-analyzer": {
      "command": "vision-mcp",
      "type": "stdio",
      "timeout": 60,
      "disabled": false,
      "autoApprove": [],