omni-lpr 0.2.0

A multi-interface (REST and MCP) server for automatic license plate recognition

Omni-LPR

A multi-interface (REST and MCP) server for automatic license plate recognition

---

Omni-LPR is a self-hostable server that provides automatic license plate recognition (ALPR) capabilities via a REST API and the Model Context Protocol (MCP). It can be used both as a standalone ALPR microservice and as an ALPR toolbox for AI agents and large language models (LLMs).

Why Omni-LPR?

Using Omni-LPR can have the following benefits:

• Decoupling. Your main application can be in any programming language. It doesn't need to be tangled up with Python or specific ML dependencies because the server handles all of that.

• Multiple Interfaces. You aren't locked into one way of communicating. You can use a standard REST API from any app, or you can use MCP, which is designed for AI agent integration.

• Ready-to-Deploy. You don't have to build it from scratch. There are pre-built Docker images that are easy to deploy and start using immediately.

• Hardware Acceleration. The server is optimized for the hardware you have. It supports generic CPUs (ONNX), Intel CPUs (OpenVINO), and NVIDIA GPUs (CUDA).

• Asynchronous I/O. It's built on Starlette, which means it has high-performance, non-blocking I/O. It can handle many concurrent requests without getting bogged down.

• Scalability. Because it's a separate service, it can be scaled independently of your main application. If you suddenly need more ALPR power, you can scale Omni-LPR up without touching anything else.

[!IMPORTANT] Omni-LPR is in early development, so bugs and breaking API changes are expected. Please use the issues page to report bugs or request features.

Quickstart

You can get started with Omni-LPR in a few minutes by following the steps described below.

1. Install the Server

You can install Omni-LPR using pip:

pip install omni-lpr

2. Start the Server

When installed, start the server with a single command:

omni-lpr

By default, the server will be listening on http://127.0.0.1:8000. You can confirm it's running by accessing the health check endpoint:

curl http://127.0.0.1:8000/api/health
# Expected output: {"status": "ok", "version": "0.2.0"}

3. Recognize a License Plate

Now you can make a request to recognize a license plate from an image. The example below uses a publicly available image URL.

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"path": "https://www.olavsplates.com/foto_n/n_cx11111.jpg"}' \
  http://127.0.0.1:8000/api/v1/tools/detect_and_recognize_plate_from_path/invoke

You should receive a JSON response with the detected license plate information.

Usage

Omni-LPR exposes its capabilities as "tools" that can be called via a REST API or over the MCP.

Core Tools

• list_models: Lists the available license plate detector and OCR models.
• recognize_plate: Recognizes text from a pre-cropped image of a license plate.
• detect_and_recognize_plate: Detects and recognizes all license plates in a full image.

The server can accept an image in three ways: a Base64-encoded string, a local file path or a URL, or as a direct file upload. For more details on how to use the different tool variations, please see the API Documentation.

REST API

The REST API provides a standard way to interact with the server. All tool endpoints are available under the /api/v1 prefix. Once the server is running, you can access interactive API documentation in the Swagger UI at http://127.0.0.1:8000/apidoc/swagger.

MCP Interface

The server also exposes its tools over the MCP for integration with AI agents and LLMs. The MCP endpoint is available at http://127.0.0.1:8000/mcp/sse.

You can use a tool like MCP Inspector to explore the available MCP tools.

Integration

You can connect any client that supports the MCP protocol to the server. The following examples show how to use the server with LMStudio.

LMStudio Configuration

{
    "mcpServers": {
        "omni-lpr-local": {
            "url": "http://localhost:8000/mcp/sse"
        }
    }
}

Tool Usage Examples

The screenshot of using the list_models tool in LMStudio to list the available models for the APLR.

The screenshot below shows using the detect_and_recognize_plate_from_path tool in LMStudio to detect and recognize the license plate from an image available on the web.

---

Documentation

Omni-LPR's documentation is available here.

Examples

Check out the examples directory for usage examples.

Feature Roadmap

• Core ALPR Capabilities

  • License plate detection.
  • License plate recognition.
  • Optimized models for CPU, OpenVINO, and CUDA backends.

• Interfaces and Developer Experience

  • MCP interface for AI agent integration.
  • REST API for all core functions/tools.
  • Standardized JSON error responses.
  • Interactive API documentation (Swagger UI and ReDoc).
  • Support for direct image uploads (multipart/form-data).

• Performance

  • Asynchronous I/O for concurrent requests.
  • Prometheus metrics endpoint (/api/metrics).
  • Request batching for model inference.

• Integrations

  • Standalone microservice architecture.
  • MCP and REST API usage examples.
  • A Python client library to simplify interaction with the REST API.

• Deployment

  • Pre-built Docker images for each hardware backend.
  • Configuration via environment variables and CLI arguments.
  • A Helm chart for Kubernetes deployment.

• Benchmarks

  • Performance benchmarks for different hardware and request types.

---

Contributing

Contributions are always welcome! Please see CONTRIBUTING.md for details on how to get started.

License

Omni-LPR is licensed under the MIT License (see LICENSE).

Acknowledgements

• This project uses the awesome fast-plate-ocr and fast-alpr Python libraries.
• The project logo is from SVG Repo.