Slov Lex Server

MCP server pre prístup k Zbierke zákonov Slovenskej republiky

Version TypeScript MCP SDK

---

Popis

Slov-Lex MCP je Model Context Protocol server, ktorý umožňuje AI asistentom pristupovať k právnym predpisom zo Slov-Lex.sk - oficiálneho právneho a informačného portálu Ministerstva spravodlivosti SR.

Funkcie

• Vyhľadávanie predpisov podľa čísla, roku alebo kľúčových slov
• Stránkované načítanie znenia predpisu k ľubovoľnému dátumu účinnosti
• Extrahovanie konkrétnych paragrafov vrátane paragrafov s priamym textom
• Podpora paragrafov, novelizačných článkov, ústavných článkov a príloh
• Podpora tabuliek - tabuľky v predpisoch sa renderujú do Markdown formátu
• RSS feed - sledovanie posledných 20 vyhlásených predpisov
• Inteligentné cachovanie pre rýchle odpovede

---

Nástroje

Nástroj	Popis
get_law	Získa základné informácie o predpise podľa čísla a roku
get_version	Načíta stránku znenia predpisu k danému dátumu
get_paragraph	Extrahuje konkrétny paragraf z predpisu
search	Vyhľadá predpisy podľa kľúčových slov (autocomplete alebo fulltext)
get_recent	Získa posledných 20 vyhlásených predpisov z RSS feedu

Každý nástroj vracia čitateľný text aj strojovo spracovateľný structuredContent. Výstupy obsahujú oficiálny zdrojový odkaz na Slov-Lex.

Parametre

get_law

Parameter	Typ	Povinný	Popis
number	string/number	áno	Číslo predpisu
year	string/number	áno	Rok vydania

get_version

Parameter	Typ	Povinný	Popis
law	string	áno	Číslo predpisu (napr. 595/2003) alebo IRI
date	string	nie	Dátum znenia YYYY-MM-DD (default: dnes v Europe/Bratislava)
max_chars	number	nie	Počet znakov jednej stránky (default: 20000, max: 100000)
offset	number	nie	Znakový offset pre pokračovanie (default: 0)

Ak odpoveď obsahuje has_more: true, ďalšiu stránku načítaj s hodnotou next_offset použitou ako nový parameter offset.

get_paragraph

Parameter	Typ	Povinný	Popis
law	string	áno	Číslo predpisu alebo IRI
paragraph	string	áno	Číslo paragrafu (napr. 3 alebo §3)
date	string	nie	Dátum znenia YYYY-MM-DD (default: dnes v Europe/Bratislava)

search

Parameter	Typ	Povinný	Popis
query	string	áno	Hľadaný výraz
mode	string	nie	Režim vyhľadávania: autocomplete (default) alebo fulltext
limit	number	nie	Max počet výsledkov (default: 10, max: 25)

Režimy vyhľadávania:

• autocomplete - predvolený režim; kombinuje návrhy, vyhľadávanie v názvoch a fulltext, odstráni duplicity a zoradí výsledky podľa relevancie
• fulltext - vyhľadávanie v názvoch a nadpisoch paragrafov (napr. "Hromadné prepúšťanie"), takisto s lokálnym zoradením relevancie

Radenie toleruje bežné rozdiely v tvaroch slov (napr. daň/dani, cestná/cestnej), rozvíja skratky DPH, GDPR a ZVO a pri rovnakej téme uprednostní účinný základný predpis pred historickými alebo novelizačnými zákonmi.

Živý audit širšej sady vyhľadávacích scenárov spustíš cez npm run audit:search. Kontroluje presné názvy, skloňovanie, text bez diakritiky, skratky, citácie, nadpisy paragrafov, všeobecné heslá, prirodzené otázky, historické predpisy, duplicity aj limity výsledkov.

get_recent

Tento nástroj nemá žiadne parametre. Vracia posledných 20 vyhlásených predpisov z RSS feedu Slov-Lex.

Poznámka: RSS feed obsahuje len 20 najnovších položiek, nie kompletný archív.

---

Rýchla inštalácia (One-liner)

Použi one-liner pre konkrétneho klienta podľa svojho AI asistenta:

Claude Code / Claude Desktop

Fetch and follow instructions from https://raw.githubusercontent.com/ESKRiPO/Slov-Lex_MCP/master/.claude/INSTALL.md

OpenAI Codex CLI

Fetch and follow instructions from https://raw.githubusercontent.com/ESKRiPO/Slov-Lex_MCP/master/.codex/INSTALL.md

Google Antigravity / Antigravity CLI

Fetch and follow instructions from https://raw.githubusercontent.com/ESKRiPO/Slov-Lex_MCP/master/.antigravity/INSTALL.md

Cursor

Fetch and follow instructions from https://raw.githubusercontent.com/ESKRiPO/Slov-Lex_MCP/master/.cursor/INSTALL.md

VS Code

Fetch and follow instructions from https://raw.githubusercontent.com/ESKRiPO/Slov-Lex_MCP/master/.vscode/INSTALL.md

Podrobné návody:

AI Systém	Podrobné inštrukcie
Claude Code / Claude Desktop	.claude/INSTALL.md
OpenAI Codex CLI	.codex/INSTALL.md
Google Antigravity / Antigravity CLI	.antigravity/INSTALL.md
Cursor	.cursor/INSTALL.md
VS Code	.vscode/INSTALL.md

---

Manuálna inštalácia

git clone https://github.com/ESKRiPO/Slov-Lex_MCP.git ~/.local/share/slov-lex-mcp
cd ~/.local/share/slov-lex-mcp
npm ci
npm run build

Priamy HTTP prístup obvykle stačí. Ak prostredie blokuje statický Slov-Lex a server ohlási chýbajúci Playwright Chromium, nainštaluj voliteľný browser fallback:

npm run install:browser

---

Aktualizácia na 1.3.1

cd ~/.local/share/slov-lex-mcp
git pull --ff-only
npm ci
npm run check

Potom reštartuj MCP klienta. Názvy existujúcich piatich nástrojov sa nezmenili. Verzia 1.3.1 zlepšuje vyhľadávanie prirodzených výrazov, radenie relevancie, rozpoznávanie bežných tvarov slov a uprednostňovanie účinných základných predpisov.

---

Použitie

Vývojový režim

npm run dev

Produkčný režim

npm run build
npm start

Kontroly projektu

npm test       # offline regresné testy
npm run check  # TypeScript build + testy
npm run smoke  # živý test proti Slov-Lex, Ústave a RSS

---

MCP Konfigurácia

Claude Code

Odporúčaná registrácia cez CLI:

claude mcp add --scope user slov-lex -- node "$HOME/.local/share/slov-lex-mcp/dist/index.js"

--scope user spraví server dostupný naprieč projektmi. Ak ho vynecháš, Claude Code použije lokálny scope.

Claude Desktop

Claude Desktop je podporovaný na macOS a Windows. Otvor Settings → Developer → Edit Config. Konfiguračný súbor je na macOS v ~/Library/Application Support/Claude/claude_desktop_config.json a na Windows v %APPDATA%\Claude\claude_desktop_config.json.

Príklad pre macOS:

{
  "mcpServers": {
    "slov-lex": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/<user>/.local/share/slov-lex-mcp/dist/index.js"]
    }
  }
}

Na Windows môže cesta v args vyzerať ako C:/Users/<user>/.local/share/slov-lex-mcp/dist/index.js. Ak Desktop nenájde príkaz node, použi v poli command jeho plnú absolútnu cestu.

OpenAI Codex CLI

Odporúčaná registrácia cez CLI:

codex mcp add slov-lex -- node "$HOME/.local/share/slov-lex-mcp/dist/index.js"

Podrobné a kanonické inštrukcie sú v .codex/INSTALL.md vrátane riešenia chyby os error 2.

Google Antigravity / Antigravity CLI

Použi globálny ~/.gemini/config/mcp_config.json alebo workspace konfiguráciu .agents/mcp_config.json:

Adresár .gemini v globálnej ceste je súčasťou aktuálneho formátu Antigravity; nejde o zastaraný Gemini CLI konfiguračný súbor.

{
  "mcpServers": {
    "slov-lex": {
      "command": "node",
      "args": ["/home/<user>/.local/share/slov-lex-mcp/dist/index.js"]
    }
  }
}

V Antigravity IDE otvor MCP Servers → Manage MCP Servers → View raw config. V Antigravity CLI otvor Interactive MCP Manager príkazom /mcp. Podrobnosti sú v .antigravity/INSTALL.md a v oficiálnej Antigravity dokumentácii.

Cursor

Pridajte do ~/.cursor/mcp.json alebo projektového .cursor/mcp.json:

{
  "mcpServers": {
    "slov-lex": {
      "command": "node",
      "args": ["/home/<user>/.local/share/slov-lex-mcp/dist/index.js"]
    }
  }
}

VS Code

Pridajte do .vscode/mcp.json v projekte alebo do user profile mcp.json:

{
  "servers": {
    "slov-lex": {
      "type": "stdio",
      "command": "node",
      "args": ["/home/<user>/.local/share/slov-lex-mcp/dist/index.js"]
    }
  }
}

---

Technológie

• Runtime: Node.js 22+
• Jazyk: TypeScript 6.0
• MCP SDK: @modelcontextprotocol/sdk 1.29
• HTML parsing: Cheerio
• Fallback browser: Playwright

Projekt nepoužíva CI/CD. GitHub Security audit kontroluje závislosti raz týždenne a dá sa spustiť aj manuálne z karty Actions; nespúšťa sa pri každom commite.

---

Dôležité upozornenie

Právne predpisy sa menia v čase. Pri použití výsledku skontroluj dátum znenia a oficiálny zdrojový odkaz. Výstup MCP servera nenahrádza právne poradenstvo.

---

Licencia

MIT

---

Autor

ESKRiPO

---

Poďakovanie

Vytvorené v spolupráci s Desiatok.sk - komunitnou AI daňovou kalkulačkou pre Slovensko.