Gemini OCR MCP

Name: Gemini OCR MCP
Author: WindoC

@WindoC

关于 Gemini OCR MCP

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

基本信息

分类

AI 与智能体

传输方式

stdio

发布者

WindoC

提交者

Antonio Cheong

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

AI 与智能体分类下的更多 MCP 服务器

MCP Manager for Claude Desktop

zueai

simple web ui to manage mcp (model context protocol) servers in the claude app

290

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768