ocr-mcp
OCR-MCP is an MCP stdio OCR service that extracts text and structured content from images using PaddleOCR.
Recognize text in images from local paths or HTTP/HTTPS URLs, with optional language (
ch,en,japan,korean, etc.) and angle classification.Recognize tables and return structured table data/text tables.
Recognize handwritten text.
Recognize math formulas and return LaTeX.
Integrate with desktop or agent clients via MCP.
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., "@ocr-mcp OCR the text from the image at /home/user/scan.png"
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.
OCR MCP Service
MCP service for OCR tasks powered by PaddleOCR.
Features
Text recognition from images
Table recognition with simple structured output
Handwriting recognition
Formula recognition with LaTeX output
Local file paths and HTTP/HTTPS URLs
MCP stdio server for desktop or agent integrations
Related MCP server: openai-vision-mcp-server
Installation
From PyPI
pip install ocr-mcpFrom source
git clone https://github.com/LinuxLinking/OCR_MCP.git
cd OCR_MCP
pip install -e .Usage
Run the MCP server:
ocr-mcpOr:
python -m ocr_mcpClaude Desktop
Add this to your Claude Desktop config:
{
"mcpServers": {
"ocr": {
"command": "ocr-mcp",
"args": []
}
}
}Tools
ocr_recognize
Recognize text in an image.
sourcerequired, local path or URLlanguageoptional, defaultch, supportsch,en,japan,koreanuse_angle_clsoptional, defaulttrue
ocr_table
Recognize a table and return a text table.
sourcerequired, local path or URLlanguageoptional, defaultch
ocr_handwrite
Recognize handwriting in an image.
sourcerequired, local path or URLlanguageoptional, defaultch
ocr_formula
Recognize formulas and return LaTeX.
sourcerequired, local path or URL
Development
pip install -e ".[dev]"
pytest tests/ -vProject Layout
src/ocr_mcp/
__init__.py
__main__.py
server.py
ocr_engine.py
table_parser.py
formula_engine.py
utils.py
tests/
pyproject.toml
LICENSE
README.mdDependencies
PaddleOCR
PaddlePaddle
OpenCV
MCP
License
MIT. See LICENSE.
Related
Available Tools
4 toolsocr_formulaA
识别图片中的数学公式,返回 LaTeX 格式。
Inputs: source (required).
ocr_handwriteB
识别图片中的手写文字内容。
Inputs: source (required), language.
ocr_recognizeC
识别图片中的文字内容。支持本地文件路径或 URL。
Inputs: source (required), language, use_angle_cls.
ocr_tableC
识别图片中的表格内容,返回结构化的表格数据。
Inputs: source (required), language.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools are mostly clearly separated by content type: general text, tables, handwriting, and formulas. There is minor overlap because ocr_recognize could plausibly also handle handwritten text or tables, but the specialized tools make their intended use clear.
All tools share the consistent ocr_ prefix, which makes the server easy to scan. The suffixes mix verbs and nouns (recognize/handwrite vs table/formula), but the pattern remains predictable and readable.
Four tools is well-scoped for an OCR server: one general recognition tool plus three specialized modes. Each tool has a clear reason to exist without overwhelming the agent.
The surface covers the main OCR use cases: plain text, tables, handwriting, and formulas. Minor gaps such as batch processing, PDF input, or language options exist, but they are not essential for the apparent core purpose.
Maintenance
Related MCP Connectors
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.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Convert files, URLs, and documents to clean, AI-ready Markdown via MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides OCR services powered by Google's Gemini API to extract text from images via file paths or base64 strings. It enables high-accuracy text recognition and CAPTCHA processing through simple MCP tools.8-
- AlicenseNot gradedqualityCmaintenanceEnables image analysis via OpenAI-compatible vision APIs, supporting local files, URLs, and base64 inputs with intelligent tiling for high-resolution images. Provides a secure, configurable MCP stdio server for structured vision analysis.91 npm3MIT
- AlicenseAqualityBmaintenanceEnables non-vision LLMs to understand images, extract text via OCR, and parse documents through a unified MCP interface, with local-first processing and optional OpenAI-compatible channels.3MIT
- FlicenseNot gradedqualityDmaintenanceProvides OCR (Optical Character Recognition) capabilities through MCP, including text extraction and document layout parsing to Markdown. Supports multiple PaddleOCR models like PP-OCRv5, PP-OCRv6, and PP-StructureV3.-