MEK MCP

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 és implementációs terv

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).

Első lépés: űrlap-paraméterek feltárása

python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
python scripts/discover_forms.py --probe

A riport: discovery/output/forms_report.json

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 (ha a team policy engedi).

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

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).

Licenc

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