Skip to main content
Glama

judikatura-mcp – MCP server pro soudní rozhodnutí ČR (rozhodnuti.justice.cz)

CI License: MIT Python

English summary. A local Model Context Protocol server (stdio) for the Czech Ministry of Justice public database of anonymised court decisions of district, regional and high courts (rozhodnuti.justice.cz). Full-text search with filters (court, legal-institute keywords, statutory provision, judge, type, dates), lookup by case number or ECLI, browsing of the official open-data API by publication date, full decision text, DOCX/TXT export and a local SQLite/FTS5 cache. Czech documentation follows.

Lokální MCP server pro Claude Desktop, Claude Code a další MCP klienty. Umožňuje asistentovi vyhledávat a číst plné texty anonymizovaných rozhodnutí okresních, krajských a vrchních soudů zveřejňovaných Ministerstvem spravedlnosti.

Nástroje

Nástroj

Zdroj

Co dělá

search_decisions

vyhledávací API webu

fulltext (všechna slova / kterékoli / přesná fráze) + filtry: soud, klíčová slova, ustanovení předpisu (§ + číslo/rok), soudce, typ rozhodnutí, datum vydání / zveřejnění, vztah k napadenému rozhodnutí

find_by_case_number

vyhledávací API webu

hledání podle spisové značky 20 C 98/2026 (doporučeno zadat i soud)

browse_published

oficiální opendata API

procházení podle data zveřejnění: roky → měsíce → dny → seznam rozhodnutí (po 100)

get_decision

oficiální opendata API

plný text podle uuid nebo ECLI (záhlaví, výrok, odůvodnění, poučení, metadata); ukládá do cache

export_decision

–

uloží rozhodnutí jako .docx nebo .txt

cache_fill, cache_fill_day

obojí

hromadně stáhne plné texty podle filtru / za den do lokální SQLite cache

cache_search

lokální cache

fulltext FTS5 bez ohledu na diakritiku (OR, "fráze", prefix*, NOT) nad staženými rozhodnutími

cache_stats

lokální cache

stav cache

list_courts, list_keywords

číselníky

109 soudů (kód → název), 1 072 klíčových slov (právních institutů)

Soudy i klíčová slova lze zadávat česky (Krajský soud v Ostravě, bezdůvodné obohacení) – server je převede na kódy. Ustanovení se zadává jako § 2991 z. č. 89/2012 Sb. nebo jen 89/2012.

Related MCP server: rechtspraak-mcp

Instalace

A) Claude Desktop – jedním kliknutím (.mcpb)

  1. Stáhněte judikatura-mcp-X.Y.Z.mcpb z Releases.

  2. Otevřete soubor dvojklikem (nebo Claude Desktop → Settings → Extensions → Advanced settings → Install Extension…).

  3. V nastavení rozšíření volitelně zadejte umístění cache a složku pro export.

Balíček používá runtime uv – Claude Desktop si sám obstará Python i závislosti.

B) Ručně (Claude Desktop, Claude Code, jiný klient)

git clone https://github.com/marshall1727/judikatura-mcp.git
cd judikatura-mcp
.\install.ps1          # vytvoří .venv, nainstaluje, spustí testy a vypíše blok pro claude_desktop_config.json

nebo s uv:

{
  "mcpServers": {
    "judikatura": {
      "command": "uv",
      "args": ["--directory", "C:\\cesta\\k\\judikatura-mcp", "run", "judikatura-mcp"]
    }
  }
}

Proměnné prostředí

Proměnná

Význam

Výchozí

JUDIKATURA_MCP_DB

soubor SQLite cache

%LOCALAPPDATA%\judikatura-mcp\cache.sqlite (Windows), ~/.local/share/judikatura-mcp/cache.sqlite

JUDIKATURA_MCP_EXPORT_DIR

složka pro export DOCX/TXT

~/Documents/judikatura-mcp

Příklady dotazů

  • „Najdi rozhodnutí Krajského soudu v Ostravě z roku 2026 k § 2991 OZ (bezdůvodné obohacení).“

  • „Vyhledej rozsudky s klíčovými slovy smluvní pokuta a ochrana spotřebitele vydané po 01.01.2026.“

  • „Najdi 8 Co 85/2026 u KSOS a ulož ho jako DOCX.“

  • „Stáhni do cache rozhodnutí OSPH01 k § 2079 OZ z letošního roku a pak v nich najdi odstoupení od smlouvy.“

  • „Co bylo zveřejněno 19.09.2026?“

Zdroje dat a omezení

  • Oficiální opendata API (https://rozhodnuti.justice.cz/opendata/) umožňuje jen procházení podle data zveřejnění a stažení detailu rozhodnutí. Používají ho browse_published, get_decision, cache_fill_day.

  • Vyhledávací endpoint /api/finaldoc?… je interní API webové aplikace (stejné, které volá formulář na webu). Není dokumentované a může se změnit bez upozornění. Používají ho search_decisions, find_by_case_number, cache_fill a dohledání podle ECLI.

  • Fulltext s velmi častými slovy („smlouva“, „žalobce“) trvá na straně serveru i desítky sekund a může skončit chybou – kombinujte s filtrem soudu, ustanovení nebo data.

  • Texty jsou anonymizované zdrojem; jména, adresy, data a částky mohou být nahrazeny placeholdery, které server zobrazuje v hranatých závorkách ([datum], [Jméno žalobkyně]). Při citaci používejte soud, spisovou značku, ECLI a datum vydání z metadat.

  • Databáze obsahuje rozhodnutí nižších soudů zveřejňovaná přibližně od roku 2021; NS, NSS a ÚS jsou v číselníku, ale primárním zdrojem pro ně zůstávají jejich vlastní databáze.

  • Server posílá nejvýše 4 souběžné požadavky; cache_fill má strop 500 rozhodnutí na volání.

  • Číselníky soudů a klíčových slov odpovídají webové aplikaci verze 2.2.0 (říjen 2026).

Vývoj

pip install -e ".[dev]"
ruff check .
pytest                          # offline testy (fixture, mock HTTP)
python scripts\build_mcpb.py    # dist\judikatura-mcp-<verze>.mcpb (vyžaduje Node.js pro npx @anthropic-ai/mcpb)

Struktura:

judikatura_mcp/      server.py (nástroje), api.py (HTTP klient), format.py (text, číselníky),
                     cache.py (SQLite + FTS5), export.py (DOCX/TXT), courts.json, flags.json
mcpb/                manifest.json, icon.png, src/server.py – podklady balíčku pro Claude Desktop
scripts/build_mcpb.py
tests/               offline testy
.github/workflows/   CI (lint, testy, build) a Release (push tagu vX.Y.Z → .mcpb, wheel, sdist, zip)

Licence

MIT. Data: Ministerstvo spravedlnosti ČR, otevřená data – https://rozhodnuti.justice.cz/opendata/

Available Tools

11 tools
browse_publishedA

Procházení oficiálního opendata API podle data ZVEŘEJNĚNÍ.

  • bez parametrů: přehled roků a počtů rozhodnutí

  • year: přehled měsíců; year+month: přehled dnů

  • year+month+day: seznam rozhodnutí zveřejněných v daný den (stránkováno po 100, page od 0); court = volitelný filtr na kód/název soudu (filtruje se lokálně v rámci stránky).

Inputs: day, page, year, court, +1 more. Returns: result

cache_fillA

Stáhne do lokální cache plné texty všech rozhodnutí odpovídajících filtru (stejné parametry jako search_decisions), nejvýše max_decisions (výchozí 50, max 500). Poté lze prohledávat offline nástrojem cache_search. Pozor: každé rozhodnutí = 1 HTTP požadavek; buďte šetrní k veřejnému serveru.

Inputs: mode, court, query, types, +7 more. Returns: result

cache_fill_dayB

Stáhne do cache všechna rozhodnutí zveřejněná v daný den (oficiální opendata API), volitelně jen pro zadaný soud (kód/název). max_decisions: strop (výchozí 100, max 500).

Inputs: day (required), year (required), month (required), court, +1 more. Returns: result

cache_statsB

Stav lokální cache: počet rozhodnutí, rozsah dat zveřejnění, nejčastější soudy, umístění databáze.

Inputs: no named parameters. Returns: result

export_decisionB

Uloží plný text rozhodnutí jako soubor. format: 'docx' | 'txt'. out_dir: cílová složka (výchozí: Dokumenty/judikatura-mcp nebo proměnná JUDIKATURA_MCP_EXPORT_DIR). filename: název souboru bez přípony (výchozí: kód soudu + spisová značka).

Inputs: uuid_or_ecli (required), format, out_dir, filename. Returns: result

find_by_case_numberA

Najde rozhodnutí podle spisové značky ve tvaru 'senát rejstřík číslo/rok' (např. '20 C 98/2026', '8 Co 85/2026'). court = kód nebo název soudu (doporučeno; stejná značka existuje u více soudů).

Inputs: case_number (required), court, limit. Returns: result

get_decisionA

Vrátí plný text rozhodnutí podle uuid nebo ECLI (např. 'ECLI:CZ:KSOS:2026:8.Co.85.2026.1'). section: 'all' | 'metadata' | 'verdict' (výrok) | 'justification' (odůvodnění) | 'header' | 'information' (poučení). Stažená rozhodnutí se ukládají do lokální cache; refresh=True vynutí nové stažení.

Inputs: uuid_or_ecli (required), refresh, section. Returns: result

list_courtsA

Číselník soudů (kód -> název). Volitelný filtr podle části názvu (bez ohledu na diakritiku), např. 'Ostrav', 'krajský', 'Praha'. Kódy se používají v parametru court u ostatních nástrojů.

Inputs: filter. Returns: result

list_keywordsA

Číselník klíčových slov (právních institutů), kterými jsou rozhodnutí označena. filter = část názvu (bez ohledu na diakritiku), např. 'smlouva', 'nájem', 'promlč'. Vrací kód -> český název. Název i kód lze použít v parametru keywords u search_decisions.

Inputs: filter (required), limit. Returns: result

search_decisionsA

Vyhledávání soudních rozhodnutí (fulltext + filtry). Používá nedokumentované API webu rozhodnuti.justice.cz.

Parametry:

  • query: hledaná slova v textu rozhodnutí.

  • mode: ALL = všechna slova, ANY = kterékoli slovo, EXACT = přesná fráze.

  • court: kód nebo název soudu; více soudů oddělit čárkou (např. 'KSOS, OSOV' nebo 'Krajský soud v Ostravě').

  • keywords: klíčová slova (kód nebo český název), více oddělit čárkou, např. 'bezdůvodné obohacení, smlouva o úvěru'.

  • regulation: dotčené ustanovení, např. '§ 2991 z. č. 89/2012 Sb.' nebo jen '89/2012' (všechna rozhodnutí citující OZ).

  • judge_last_name / judge_first_name: soudce.

  • types: 'JUDGEMENT' (rozsudek), 'ORDER_T' (trestní příkaz), 'RESOLUTION' (usnesení); více oddělit čárkou. Výchozí: vše.

  • issued_from/issued_to: datum vydání (YYYY-MM-DD). published_from/published_to: datum zveřejnění.

  • affected: vztah k napadenému rozhodnutí: 'CONFIRM', 'CHANGE', 'CANCEL', 'COMPLETE', 'CORRECT', 'REPLACE' (čárkou).

  • sort_by: PUBLISHED_AT | DECISION_AT; sort_direction: DESC | ASC.

  • page (od 0), limit (max 100).

Vrací seznam s uuid, ECLI, soudem, spisovou značkou, daty, předmětem a zkráceným výrokem. Plný text získáte nástrojem get_decision(uuid).

Inputs: mode, page, court, limit, +13 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes: lookup tables (list_courts/list_keywords), online search (search_decisions), case-number lookup (find_by_case_number), date browsing (browse_published), full-text retrieval (get_decision), export, and cache operations. There is mild overlap among the several 'find decisions' tools and between cache_fill and cache_fill_day, but descriptions make the intended boundary clear.

    Naming Consistency4/5

    Names follow a predictable snake_case convention, mostly verb_noun (list_courts, search_decisions, get_decision, export_decision). The cache group uses a noun-prefixed namespace (cache_fill, cache_fill_day, cache_search, cache_stats), a minor deviation but logically grouped and readable.

    Tool Count5/5

    11 tools is well-scoped for a judicial-decisions server, covering discovery, retrieval, export, and offline cache workflow. Each tool earns its place with no filler.

    Completeness4/5

    The surface covers the full lifecycle of finding, retrieving, exporting, and caching decisions, including offline search and status. Minor gaps such as citation/related-decision lookup exist, but core workflows are covered without dead ends.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables searching Polish Constitutional Tribunal judgments and rulings (with facet filters and sorting) and fetching the full HTML text of a given judgment directly from trybunal.gov.pl, without authentication.
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to search, read and cross-check a local, offline SQLite corpus of STJ and TJSC appellate decisions (ementas), accepted repetitive themes and súmulas, plus citations between them, through five read-only tools. Coverage is partial and declared, so every search reports its sources, delays and gaps.
      1
      MIT