RapidOCR MCP Server

High-performance OCR MCP Server.

Features

• Multi-mode: MCP stdio, FastAPI HTTP, streamable-http

• Multi-input: Path, Base64, URL, File upload

• Batch OCR: Process multiple images in one request

• Output formats: Plain, JSON, Markdown, Structured

• Image preprocessing: Auto-enhance, rotate, binarize

• Security: Path whitelist, API key, CORS, audit logging

• Monitoring: Prometheus metrics, OpenTelemetry tracing

• Production-ready: Docker, CI/CD, tests

Related MCP server: document-reader-mcp

Quick Start

Global Installation

# Install globally with uvx (recommended)
uvx rapidocr-mcp

# Or install globally with pip
pip install rapidocr-mcp

Local Development

# Install dependencies
uv sync

# Run MCP server (stdio mode)
uv run rapidocr-mcp

# Run FastAPI server
uv run rapidocr-mcp --mode fastapi --port 8080

Configuration

Set environment variables with RAPIDOCR_ prefix:

export RAPIDOCR_LANG=ch
export RAPIDOCR_LOG_LEVEL=INFO
export RAPIDOCR_API_KEY=your-key

MCP Configuration

Available Tools

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rapidocr": {
      "command": "uvx",
      "args": ["rapidocr-mcp"]
    }
  }
}

Or with local installation:

{
  "mcpServers": {
    "rapidocr": {
      "command": "uv",
      "args": ["--directory", "/path/to/rapidocr-mcp", "run", "rapidocr-mcp"]
    }
  }
}

Other MCP Clients

For other MCP clients that support stdio mode, configure the command as:

uvx rapidocr-mcp
# or
rapidocr-mcp

Docker

docker-compose -f docker/docker-compose.yml up

API Endpoints

• GET /health - Health check

• POST /ocr/path - OCR by file path

• POST /ocr/base64 - OCR by base64

• POST /ocr/url - OCR by URL

• POST /ocr/upload - OCR by file upload

• GET /metrics - Prometheus metrics

Sponsoring

If you find this project helpful, consider buying me a coffee!

License

MIT