pi-mcp-ocr
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pi-mcp-ocrExtract text from this image"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pi-mcp-ocr
Modular OCR MCP server with pluggable backends: Apple Vision, PaddleOCR, and PaddleOCR-VL.
Installation
# Recommended (macOS Apple Silicon):
pip install git+https://github.com/timaliev/pi-mcp_ocr.git#egg=pi-mcp-ocr[vision,paddleocr-vl]
# Cross-platform:
pip install git+https://github.com/timaliev/pi-mcp_ocr.git#egg=pi-mcp-ocr[paddle]Optional dependency groups
Group | Backend | Requirements |
| Apple Vision | macOS 10.15+ |
| PaddleOCR | Cross-platform, CPU |
| PaddleOCR-VL | macOS 14+, Apple Silicon, |
| Everything | All of the above |
Related MCP server: MCP OCR Server
Configuration
Add to your MCP client config (e.g., mcp.json for pi):
{
"mcpServers": {
"ocr": {
"command": "mcp-ocr",
"args": []
}
}
}Backends
Vision (ocr_text_vision, ocr_layout_vision, ocr_table_vision)
macOS 10.15+, zero install
GPU/ANE accelerated
Best for: CJK + major European languages, fast extraction
Paddle (ocr_text_paddle, ocr_layout_paddle, ocr_table_paddle)
Cross-platform CPU
Mature PaddleOCR models
Best for: wide language coverage, when not on macOS
PaddleOCR-VL (ocr_text_paddleocr_vl, ocr_table_paddleocr_vl, ocr_formula_paddleocr_vl, ocr_chart_paddleocr_vl)
macOS 14+, Apple Silicon (M1/M2/M3/M4)
0.9B vision-language model, 109 languages
Best for: highest accuracy, formulas, charts, tables
Requires:
paddleocr-vlCLI from https://github.com/mlx-community/paddleocr-vl.swift
Environment Variables
Variable | Default | Description |
|
| Path to paddleocr-vl CLI binary |
|
| Timeout in seconds for PaddleOCR-VL |
Development
git clone https://github.com/timaliev/pi-mcp_ocr.git
cd pi-mcp_ocr
pip install -e .[all]
pytestThis server cannot be deployed
Maintenance
Related MCP Connectors
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
OCR.space MCP — wraps the OCR.space API (ocr.space) for image/PDF → text OCR.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceA macOS-based MCP server that enables high-accuracy text extraction from PDF and image files using the OwlOCR app or Apple's Vision Framework. It supports multi-language OCR and provides asynchronous tools for processing documents directly within MCP clients.MIT
- AlicenseNot gradedqualityDmaintenanceHigh-performance OCR server using native Tesseract (C++) for text extraction from images, integrable with ChatGPT Desktop and other MCP clients.11MIT
- AlicenseAqualityDmaintenanceHigh-performance OCR MCP server supporting multiple input modes (path, base64, URL, upload), batch processing, and output formats like plain, JSON, and Markdown.42MIT
- AlicenseCqualityBmaintenanceA local OCR MCP server that extracts text from images using PP-OCRv6 for fast text extraction and VL-1.6 for document structure analysis, with automatic model routing and GPU detection.32MIT