# omni-lpr

omni-lpr — a self-hosted server that finds and reads license plates in images. It talks to agents over MCP and to any app over REST, so your main codebase stays free of ML dependencies.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27 repo stars
- Author: habedi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/habedi/omni-lpr
- Updated: 2026-07-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/omni-lpr

## What it does

omni-lpr detects plates in a full photo and reads the text from pre-cropped plate images. Pictures can arrive as Base64, file upload, a local path or a URL. The tools list available detector and OCR models as well.

Run it with `pip install omni-lpr`, then start it with the `omni-lpr` command. It listens on `http://127.0.0.1:8000` by default. The MCP endpoint sits at `http://127.0.0.1:8000/mcp/` over streamable HTTP, and Swagger UI is at `http://127.0.0.1:8000/api/v1/apidoc/swagger`. MCP Inspector works for poking at the tools before wiring an agent in.

Python 3.10 to 3.13 is required. Docker images cover plain CPU via ONNX, Intel chips via OpenVINO and NVIDIA GPUs via CUDA. The project is in early development, so API changes that break things are likely — pin a version if you build on it.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://{baseUrl}/mcp/`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http omni-lpr https://{baseUrl}/mcp/
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add omni-lpr --url https://{baseUrl}/mcp/
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "omni-lpr": {
            "url": "https://{baseUrl}/mcp/"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "omni-lpr": {
            "type": "http",
            "url": "https://{baseUrl}/mcp/"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http omni-lpr https://{baseUrl}/mcp/
```

## When to use it
- detect every plate in a full image and read the text
- recognize text from an already cropped plate picture
- give an AI agent license plate recognition through MCP tools
- keep plate recognition as a separate service instead of dragging Python and ML deps into the main app
- pick hardware acceleration: ONNX for CPU, OpenVINO for Intel, CUDA for NVIDIA

## Example prompts
- Read the plate from https://www.olavsplates.com/foto_n/n_cx11111.jpg
- Find and recognize all license plates in this image
- List the available detection and OCR models

## Similar
- [omni-combos-routing](https://affpapa.org/en/nevibecode/skills/omni-combos-routing.md) — skill · 1600 installs
- [omni-inference](https://affpapa.org/en/nevibecode/skills/omni-inference.md) — skill · 1400 installs
- [google-gemini-omni-video](https://affpapa.org/en/nevibecode/skills/google-gemini-omni-video.md) — skill · 144 installs
- [scenario-gemini-omni](https://affpapa.org/en/nevibecode/skills/scenario-gemini-omni.md) — skill · 845 installs
- [service-omni-channel-setup-coordinate](https://affpapa.org/en/nevibecode/skills/service-omni-channel-setup-coordinate.md) — skill · 140 installs
- [catalyst-zia](https://affpapa.org/en/nevibecode/skills/catalyst-zia.md) — skill · 1200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
