browser-ocr-mcp

browser-ocr-mcp

MCP server for local OCR via Tesseract.js. Extract text from images and browser screenshots without sending image data to the LLM.

Why

When browsing with Playwright MCP, you often encounter pages where text is embedded in images. Normally you'd send the screenshot to the LLM — slow, bandwidth-heavy. This server runs Tesseract.js locally so the image never leaves your machine.

Tools

ocr_image

Extract text from an image file or URL. Zero browser setup required.

Input:

• path (string, optional) — Absolute path to a local image file
• url (string, optional) — HTTP URL to download the image from

Output: ``json { "text": "The quick brown fox jumps over the lazy dog", "confidence": 85, "wordCount": 9 } ``

Typical workflow with Playwright MCP: ```

1. browser_take_screenshot({ filename: "page.png" })
2. ocr_image({ path: "/home/user/page.png" })
3. → text returned, zero image data sent to LLM

### `browser_ocr`

Take a screenshot of the current browser page via CDP and OCR it — all in one call. Requires a shared Chromium instance.

**Input:**
- `fullPage` (boolean, optional) — Capture full scrollable page. Default: `false`

**Setup (one-time):**

Terminal 1: Launch Chromium with debugging port

chromium --remote-debugging-port=9222

Terminal 2: Start Playwright MCP connected to it

npx @playwright/mcp --cdp-endpoint http://localhost:9222

Terminal 3: Start OCR MCP server

node server.js --cdp-endpoint http://localhost:9222 ```

Install

git clone https://github.com/Ismapik/browser-ocr-mcp.git
cd browser-ocr-mcp
npm install

The first time you run OCR, Tesseract.js downloads English language data (~12 MB). Subsequent runs use the cached data.

MCP Client Config

Add to your MCP client configuration (e.g., mcp.json or Claude Desktop config):

{
  "mcpServers": {
    "browser-ocr": {
      "command": "node",
      "args": ["/path/to/browser-ocr-mcp/server.js"],
      "env": {
        "CDP_ENDPOINT": "http://localhost:9222"
      }
    }
  }
}

The CDP_ENDPOINT env var is only needed if you use the browser_ocr tool. The ocr_image tool works without it.

Test

npm test

Runs a test suite that:

1. Starts the MCP server
2. Calls ocr_image on a sample image
3. Verifies text extraction, confidence, and word count
4. Tests error handling for missing/invalid inputs

Requirements

• Node.js ≥ 18
• Chromium (only for browser_ocr tool)
• playwright-core (optional, only for browser_ocr)

License

MIT