EPO Register MCP

This repository implements the MVP for an MCP (Model Context Protocol) server that retrieves document metadata from the European Patent Register.

Local setup

1. Create and activate a virtual environment

   python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate

2. Install dependencies

   pip install -U pip pip install -e .[default]

   If you prefer pip installs without pyproject extras:

   pip install pydantic beautifulsoup4 requests playwright fastmcp pytest

3. Install Playwright browsers (required only for Playwright fallback)

   playwright install chromium

Run the MCP server (requires fastmcp installed)

python -m src.server

If fastmcp is not installed, the module exposes a simple HTTP health endpoint instead:

uvicorn src.server:app --reload --port 8000

Inspecting and calling the tool

• The MCP tool is named get_ep_register_documents and accepts a single input field: { "applicationNumber": "EP07848397" }

Running tests

pytest -q

Notes

• No PDF download or dossier download functionality has been implemented.

• The code intentionally avoids any CAPTCHA solving, stealth plugins, or access-control bypass.