MEK

Python MCP szerver a Magyar Elektronikus Könyvtár keresőinek eléréséhez agentic eszközök számára.

Dokumentáció

• Architektúra

MCP toolok

Tool	Leírás
mek_search_simple	Egyszerű metaadat-keresés (szerző, cím, téma, MEK ID)
mek_search_fulltext	Teljes szöveg keresés HTML/PDF dokumentumokban
mek_search_advanced	Összetett keresés — max. 5 mezősor, AND/OR/NOT (Playwright scraping)
mek_list_search_fields	Elérhető mező-aliasok és fulltext témakörök

Találati limitek

Keresés	Default	Lapozás
Egyszerű / fulltext	page_size=10 (max 100)	page paraméterrel
Összetett	max_results=50	Nincs — a MEK egy listában adja vissza az összes találatot

Minden válasz tartalmazza a total_hits értéket (teljes találatszám) és a documents szeletet (amit az LLM kap).

Telepítés

python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
playwright install chromium

Az összetett kereséshez Playwright + Chromium szükséges (headless böngésző scraping a detailed oldalhoz).

Tesztelés

pytest -m "not network"    # offline tesztek
pytest -m network          # élő MEK hálózati tesztek

Cursor MCP konfiguráció

A projekt tartalmazza: .cursor/mcp.json

{
  "mcpServers": {
    "mek": {
      "command": "${workspaceFolder}/.venv/Scripts/python.exe",
      "args": ["-m", "mek_mcp.server"],
      "cwd": "${workspaceFolder}"
    }
  }
}

Előfeltétel: pip install -e ".[dev]" a .venv-ben. Cursorban: Settings → MCP → a mek szerver engedélyezése.

Render deploy (Streamable HTTP)

Docker (ajánlott)

docker build -t mek-mcp .
docker run --rm -p 10000:10000 -e MCP_TRANSPORT=streamable-http -e HOST=0.0.0.0 mek-mcp

Health check: http://localhost:10000/health

MCP végpont: http://localhost:10000/mcp

Render Web Service

1. Push a repót GitHubra
2. Render Dashboard → New → Blueprint → válaszd a render.yaml-t
   (vagy New → Web Service → Docker runtime, Dockerfile útvonal)
3. A PORT változót a Render automatikusan beállítja

Változó	Érték
MCP_TRANSPORT	streamable-http
HOST	0.0.0.0
MEK_PLAYWRIGHT_HEADLESS	true
MEK_SCRAPE_TIMEOUT_MS	90000

Start command (Dockerfile-ből automatikus): python -m mek_mcp.server

Health check: GET /health

MCP végpont (alapértelmezés):

• Streamable HTTP: https://<service>.onrender.com/mcp

Legacy SSE (opcionális, MCP_TRANSPORT=sse):

• SSE stream: https://<service>.onrender.com/sse
• Üzenetek: https://<service>.onrender.com/messages/

A Playwright Chromium a Docker image része (mcr.microsoft.com/playwright/python).

Fejlesztés: űrlap-paraméterek feltárása

python scripts/discover_forms.py --probe

A riport: discovery/output/forms_report.json

Licenc

A MEK tartalmára az OSZK felhasználási feltételei vonatkoznak. Ez a projekt nem hivatalos OSZK/MEK termék.