convez.ai
MCP Server
Prekzursil

abbyy-finereader-ocr-mcp

Prekzursil/abbyy-finereader-ocr-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

Multi-engine OCR MCP server (RapidOCR + Tesseract + ABBYY FineReader 16) with per-line confidence, engine comparison, and CER/WER accuracy evaluation. Local/headless, Windows-first.

Instalação

$npx convez-ai Prekzursil/abbyy-finereader-ocr-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

abbyy-finereader-ocr-mcp — Multi-Engine OCR MCP Server

A Model Context Protocol server that gives AI assistants (Claude Code, Codex, Cursor, …) OCR with first-class accuracy handling and evaluation. It wraps three engines behind one interface and can score and compare them:

EngineBackendLocal?ConfidenceNotes
RapidOCR (default)PaddleOCR models on onnxruntime✅ fully local/headlessper-lineNo GPU/torch needed; great default
TesseractGoogle Tesseract via pytesseract✅ localper-wordNeeds tesseract.exe on PATH
ABBYY FineReader 16local FineReader Regular CLI (/send Clipboard)✅ local—Best accuracy; GUI flashes, 1 doc at a time. Headless file output needs ABBYY's paid Extended CLI

Why multi-engine? No single OCR engine wins on every document. This server lets the model run several, compare their agreement, and score them against ground truth (CER/WER) — so you can pick the right engine per job instead of guessing.

Features

  • 📄 OCR images and PDFs (PDFs rasterized via PyMuPDF, per-page OCR).
  • 🎯 Confidence scores per line/word, with low-confidence flagging.
  • ⚖️ compare_engines — run every available engine on one document and report pairwise agreement + a consensus pick (no ground truth required).
  • 📏 evaluate_accuracy — CER / WER, char/word accuracy %, and edit breakdown (substitutions/deletions/insertions) against a ground-truth text file.
  • 🧹 Optional preprocessing (grayscale / denoise / deskew via OpenCV).
  • 🧱 Fails soft: an unavailable engine is reported, never crashes the server.

Tools

ToolDescription
list_engines()Which engines are usable on this machine + status. Call first.
ocr_image(path, engine="auto", lang="en", preprocess=False)OCR one image.
ocr_pdf(path, engine="auto", lang="en", pages="all", dpi=300)OCR a PDF.
batch_ocr(paths_or_glob, engine="auto", lang="en")OCR many images (glob or JSON list).
compare_engines(path, lang="en")Run all engines, compare agreement + consensus.
evaluate_accuracy(ground_truth_path, ocr_text="" | ocr_path="", engine, lang)CER/WER vs ground truth.

engine ∈ auto (=RapidOCR) · rapidocr · tesseract · finereader. lang is an ISO-639-1 code (en, de, fr, ro, zh, …), mapped per engine.

Requirements

  • Python ≥ 3.12 (3.12 recommended — all wheels mature; 3.14 also works for the core RapidOCR path but OpenCV/PyMuPDF wheels may lag).
  • Tesseract (optional): install Tesseract-OCR and add tesseract.exe to PATH for that engine.
  • ABBYY FineReader 16 (optional): a local install enables the FineReader engine (Regular-CLI clipboard mode). Headless file output requires ABBYY's Extended CLI license.

Install

git clone https://github.com/Prekzursil/abbyy-finereader-ocr-mcp
cd abbyy-finereader-ocr-mcp
uv venv --python 3.12
uv pip install -e .
# (first OCR call downloads the small RapidOCR ONNX models, ~?? MB, cached locally)

Configure

Claude Code

claude mcp add ocr -s user -- "/abs/path/abbyy-finereader-ocr-mcp/.venv/Scripts/python.exe" "/abs/path/abbyy-finereader-ocr-mcp/index.py"

Codex (~/.codex/config.toml)

[mcp_servers.ocr]
command = "D:\\path\\abbyy-finereader-ocr-mcp\\.venv\\Scripts\\python.exe"
args = ["D:\\path\\abbyy-finereader-ocr-mcp\\index.py"]
startup_timeout_sec = 60
tool_timeout_sec = 300

[mcp_servers.ocr.env]
PYTHONUTF8 = "1"
PYTHONUNBUFFERED = "1"

Generic MCP client (mcp.json)

{
  "mcpServers": {
    "ocr": { "command": "/abs/path/.venv/bin/python", "args": ["/abs/path/index.py"] }
  }
}

Usage examples

> OCR this scan and tell me how confident you are.
  → ocr_image("C:/scans/invoice.png")  → text + mean_confidence + low-confidence lines

> Which engine reads this receipt best?
  → compare_engines("C:/scans/receipt.jpg")  → per-engine text + agreement + consensus

> How accurate is RapidOCR on this page vs my transcript?
  → evaluate_accuracy("truth.txt", ocr_path="page.png", engine="rapidocr") → CER/WER

Evaluation methodology

evaluate_accuracy uses jiwer for CER (character error rate) and WER (word error rate). Lower is better; char_accuracy_pct = (1 − CER)·100. Keep ground-truth .txt files next to your test images to track engine accuracy over time. compare_engines is the no-ground-truth fallback: it reports how much the engines agree and which one is the consensus.

Development

uv pip install -e ".[test]"
pytest        # renders known text → OCR → asserts recovery + low CER

Security

This server reads any file path the MCP client gives it — i.e. any file readable by the server process. There is no sandbox by default. Run it only with a trusted MCP client, and be aware that an LLM driving the tools could be prompted to read arbitrary local files.

For defense-in-depth, set OCR_MCP_ALLOWED_DIRS (an os.pathsep-separated list of directories) to restrict all tools to files under those roots:

[mcp_servers.ocr.env]
OCR_MCP_ALLOWED_DIRS = "D:\\scans;D:\\documents"

Also note: batch_ocr with a recursive glob (**/*.png) can match very large file sets — scope your globs. The FineReader engine shells out to the local FineReaderOCR.exe (list-form args, no shell) and reads the OS clipboard.

License

MIT — see LICENSE.

Acknowledgements

RapidOCR · Tesseract · ABBYY FineReader · jiwer · PyMuPDF · MCP

Ver o original no GitHub

Bom para

Relacionados