🪪 Document OCR MCP Server

An AI-powered MCP (Model Context Protocol) server that extracts structured data from Indian identity documents using OCR. Connect it to Claude Desktop and let Claude read your documents!

📋 Supported Documents

* Sensitive fields are masked by default for privacy.

Related MCP server: KnowledgeMCP

🚀 Quick Start

Step 1: Install Tesseract OCR (Windows)

Tesseract must be installed separately — it's the OCR engine under the hood.

1. Download from: https://github.com/UB-Mannheim/tesseract/wiki

2. Run the installer (choose Additional script data → Hindi if needed)

3. Default install path: C:\Program Files\Tesseract-OCR\tesseract.exe

4. Add to PATH, or set in your environment:

   $env:TESSDATA_PREFIX = "C:\Program Files\Tesseract-OCR\tessdata"

Step 2: Install Python Dependencies

cd d:\mcp
pip install -r requirements.txt

Step 3: Test the Server

# Run the MCP Inspector (opens browser UI to test tools)
fastmcp dev server.py

Or test directly:

python server.py

🤝 Connect to Claude Desktop

1. Find your Claude Desktop config file:

   C:\Users\<YourName>\AppData\Roaming\Claude\claude_desktop_config.json

2. Add this to the config:

   {
     "mcpServers": {
       "document-ocr": {
         "command": "python",
         "args": ["d:\\mcp\\server.py"]
       }
     }
   }

3. Restart Claude Desktop

4. You'll see the 🔌 tools icon — your OCR tools are ready!

💬 Example Claude Prompts

Once connected, you can ask Claude:

Extract all information from my Aadhaar card at C:/Users/me/aadhaar.jpg

What's the expiry date on my passport? Image is at D:/docs/passport.png

Read the PAN card image at C:/scans/pan.jpg and tell me the PAN number

Auto-detect what type of document this is and extract all fields:
C:/Downloads/document.jpg

Get raw text from this image: C:/photos/certificate.png

🛠️ MCP Tools Reference

extract_aadhaar(image_path, show_full=False)

Extract data from Aadhaar card front or back.

extract_passport(image_path, show_full=False)

Extract data from passport bio-data page. Uses MRZ parsing for high accuracy.

extract_pan_card(image_path, show_full=False)

Extract data from PAN card.

extract_driving_license(image_path, show_full=False)

Extract data from Driving License (front side recommended).

extract_any_document(image_path, document_type="auto", show_full=False)

Auto-detect document type and extract accordingly.

ocr_raw_text(image_path, language="eng")

Get raw OCR text from any image. Supports multi-language:

• "eng" — English

• "hin" — Hindi

• "eng+hin" — English + Hindi

• "eng+tam" — English + Tamil

🔒 Privacy & Security

• Aadhaar numbers are masked to XXXX XXXX 1234 by default

• PAN numbers are partially masked to AB*****4F by default

• Passport numbers are partially masked by default

• MRZ lines are redacted by default

• Pass show_full=True to any tool to disable masking

• All processing is 100% local — no data is sent to any cloud service

📁 Project Structure

d:\mcp\
├── server.py              # FastMCP server (entry point)
├── requirements.txt       # Python dependencies
├── pyproject.toml         # Project config
│
├── tools/
│   ├── aadhaar.py         # Aadhaar OCR
│   ├── passport.py        # Passport OCR + MRZ parser
│   ├── pan_card.py        # PAN Card OCR
│   ├── driving_license.py # Driving License OCR
│   └── generic_ocr.py    # Generic + auto-detect OCR
│
├── utils/
│   ├── image_preprocess.py  # OpenCV preprocessing pipeline
│   ├── validators.py        # Pydantic output models
│   └── privacy.py           # PII masking utilities
│
└── samples/               # Place test images here

⚠️ Troubleshooting

📜 License

MIT License — free to use and modify.