MCP Image Recognition Server

by mario-andreschak

39 stars
841 downloads
Not rated
GitHub

About

An MCP server that provides image recognition 👀 capabilities using Anthropic and OpenAI vision APIs

Details

Author
mario-andreschak
GitHub stars
39
Downloads
841
Categories
Media

- Image description using Claude Vision or GPT-4 Vision
- Support for JPEG, PNG, GIF, WebP formats
- Configurable primary and fallback provider (Anthropic/OpenAI)
- Base64 and file-based image input
- Optional Tesseract OCR text extraction
- OpenRouter support for additional models

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Image Recognition Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, copy .env.example to .env, set API keys and preferences, then build and run via python -m image_recognition_server.server or run.bat server. Use tools describe_image (base64 input) and describe_image_from_file (file path). Environment variables control provider, model, OCR, and logging.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp image recognition server": {
            "mcp-image-recognition": {
                "command": "python",
                "args": [
                    "-m",
                    "image_recognition_server.server"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-image-recognition": {
        "command": "python",
        "args": [
            "-m",
            "image_recognition_server.server"
        ]
    }
}

MCP Image Recognition Server

An MCP server that provides image recognition capabilities using Anthropic and OpenAI vision APIs. Version 0.1.2.

Features

- Image description using Anthropic Claude Vision or OpenAI GPT-4 Vision
- Support for multiple image formats (JPEG, PNG, GIF, WebP)
- Configurable primary and fallback providers
- Base64 and file-based image input support
- Optional text extraction using Tesseract OCR

Requirements

- Python 3.8 or higher
- Tesseract OCR (optional) - Required for text extraction feature
- Windows: Download and install from UB-Mannheim/tesseract
- Linux: sudo apt-get install tesseract-ocr
- macOS: brew install tesseract

Installation

1. Clone the repository:

git clone https://github.com/mario-andreschak/mcp-image-recognition.git
cd mcp-image-recognition

2. Create and configure your environment file:
```bash
cp .env.example .env

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.