Gemini OCR MCP

Created By

WindoC9 months ago

This project provides a simple yet powerful OCR (Optical Character Recognition) service through a FastMCP server, leveraging the capabilities of the Google Gemini API. It allows you to extract text from images either by providing a file path or a base64 encoded string.

# ocr

# gemini

Overview Content Tools Comments

Overview

This project, Gemini OCR MCP Server, is a Python-based service that provides Optical Character Recognition (OCR) capabilities using the Google Gemini API. It is designed to run as a FastMCP server, exposing OCR functionality as simple tools that can be accessed programmatically.

Key Features

File-based OCR: Extract text from local image files.
Base64 OCR: Extract text from images provided as base64-encoded strings.
Google Gemini Integration: Utilizes advanced Gemini models for high-accuracy text recognition.
Easy Integration: Can be configured as a server in a parent MCP application.

How It Works

The server exposes two main tools:
- ocr_image_file: Accepts a file path, reads the image, and returns the extracted text.
- ocr_image_base64: Accepts a base64-encoded image string and returns the extracted text.
Both tools use the Google Gemini API to perform OCR, requiring a valid API key and model specification via environment variables.

Usage

Clone the repository and install dependencies.
Set up your environment with the required Google Gemini API credentials.
Run the server or integrate it into your MCP configuration.
Use the provided tools to extract text from images either by file path or base64 string.

Example

Extract the text from an image (e.g., a CAPTCHA) and convert it to plain text using the provided tools.

Server Config

{
  "mcpServers": {
    "gemini-ocr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/project/gemini-ocr-mcp",
        "run",
        "gemini-ocr-mcp.py"
      ],
      "env": {
        "GEMINI_MODEL": "gemini-2.5-flash-preview-05-20",
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Tavily Mcp

CursorThe AI Code Editor

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Amap Maps高德地图官方 MCP Server

WindsurfThe new purpose-built IDE to harness magic

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

ChatWiseThe second fastest AI chatbot™

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.