Gemini OCR MCP
@WindoC
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.
Overview
What is Gemini OCR MCP?
Gemini OCR MCP is an MCP server that provides Optical Character Recognition (OCR) by leveraging the Google Gemini API. It allows you to extract text from images either by providing a file path or a base64-encoded string, making it useful for developers who need programmatic text extraction from images.
How to use Gemini OCR MCP?
Clone the repository, install dependencies with uv sync, and configure the server in your MCP client’s config.json using the provided Windows/macOS/Linux examples. Set the environment variables GEMINI_API_KEY and optionally GEMINI_MODEL, then invoke the tools ocr_image_file (with an image file path) or ocr_image_base64 (with a base64 image string).
Key features of Gemini OCR MCP
- File-based OCR from local images
- Base64 OCR from encoded image strings
- Powered by Google Gemini models for high accuracy
- Simple tool-based interface via FastMCP
Use cases of Gemini OCR MCP
- Extracting text from CAPTCHA images
- Digitizing text from scanned documents or photos
- Processing images received as base64 data in APIs
FAQ from Gemini OCR MCP
What are the prerequisites for running Gemini OCR MCP?
You need Python 3.8 or higher and a valid Google Gemini API Key from Google AI Studio.
How do I configure Gemini OCR MCP for my MCP client?
Add a configuration entry to your MCP client’s config.json specifying the command uv, the project directory, and environment variables GEMINI_API_KEY and GEMINI_MODEL (optional). Example configurations for Windows and Linux/macOS are provided in the README.
Which Gemini model does Gemini OCR MCP use?
The default model is gemini-2.5-flash-preview-05-20, but you can override it by setting the GEMINI_MODEL environment variable.
What tools does Gemini OCR MCP provide?
It provides two tools: ocr_image_file (accepts an image file path) and ocr_image_base64 (accepts a base64-encoded image string). Both return the extracted text.
How does Gemini OCR MCP handle authentication?
It reads the Google Gemini API key from the GEMINI_API_KEY environment variable. No other authentication or transport configuration is required beyond standard MCP setup.
