kataster-mcp 0.3.0__tar.gz

kataster_mcp-0.3.0/.gitignore

@@ -0,0 +1,26 @@
+# venv, cache, build
+.venv/
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+
+# lokálne dáta a cache (osobné údaje!)
+/data/
+*.sqlite
+*.sqlite-*
+snapshots/
+*.log
+
+# zálohy
+*.bak*
+*.pred-*
+
+# lokálne nastavenia klienta
+.claude/settings.local.json
+
+# lokálny pin z update-mcp-venvs.sh (verejne platí requires-python)
+.python-version

kataster_mcp-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Branislav Klocok
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kataster_mcp-0.3.0/PKG-INFO

@@ -0,0 +1,173 @@
+Metadata-Version: 2.5
+Name: kataster-mcp
+Version: 0.3.0
+Summary: MCP server for the Slovak land registry (kataster nehnuteľností SR): parcels, LV, owners, soil, LPIS, floods, nature protection, maps
+Project-URL: Homepage, https://github.com/braklo/kataster-mcp
+Project-URL: Issues, https://github.com/braklo/kataster-mcp/issues
+Author-email: Branislav Klocok <branislav.klocok@orava.sk>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cadastre,kataster,mcp,slovakia
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Slovak
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]<3,>=2.3
+Requires-Dist: pillow>=12.3.0
+Requires-Dist: pypdf>=6.19.0
+Requires-Dist: shapely>=2.2.0
+Requires-Dist: tzdata>=2026.5; sys_platform == 'win32'
+Description-Content-Type: text/markdown
+
+# kataster-mcp
+
+MCP server pre kataster nehnuteľností Slovenskej republiky. Umožňuje AI asistentovi alebo jazykovému modelu
+v ľubovoľnom klientovi s podporou [Model Context Protocol](https://modelcontextprotocol.io) zistiť o konkrétnom pozemku
+čo najviac z verejných zdrojov: hranice a výmeru parcely, list vlastníctva a vlastníkov,
+bonitu pôdy, úradnú hodnotu, LPIS, záplavové územia, ochranu prírody, les, sklon terénu, siete a mapu.
+
+*English: an MCP server for the Slovak land registry. An English README is in preparation.*
+
+Údaje majú informatívny charakter. Nie sú výpisom z listu vlastníctva a nedajú sa použiť na právne úkony.
+
+## Čo vie
+
+| Nástroj | Čo vráti |
+|---|---|
+| `kataster_ku` | katastrálne územie podľa názvu alebo kódu (obec, okres) |
+| `kataster_parcela` | parcelu registra C alebo E podľa čísla alebo súradníc: výmera, hranica, referenčný bod |
+| `kataster_vlastnici` | vlastníkov a podiely jednej zadanej parcely a číslo listu vlastníctva; na požiadanie (`detail_stavieb`) aj detail stavby na nej: LV stavby, druh a vlastníkov (každá stavba je ďalší dotaz do denného limitu; pri bytovom dome vlastníkov bytov nevracia, namiesto toho navedie, ako si uložiť a naimportovať list vlastníctva domu) |
+| `kataster_vrstvy` | tematické údaje o parcele (zoznam nižšie), pri plošných vrstvách aj podiel na výmere |
+| `kataster_skupina` | rozbor viacerých parciel: celková výmera, spoločné hranice, súvislé celky, susedia |
+| `kataster_mapa` | mapu parcely ako PNG, HTML (Leaflet), GeoJSON alebo KML, bez osobných údajov |
+| `kataster_lv` | odkaz na výpis z listu vlastníctva na portáli ESKN (výpis si otvoríte sami) |
+| `kataster_osoba_navod` | postup krok za krokom, ako si v oficiálnom vyhľadávaní portálu ESKN nájsť listy vlastníctva osoby a uložiť ich náhľady (server pri tom na portál nevolá) |
+| `kataster_lv_import` | načítanie výpisu LV alebo náhľadu LV, ktorý ste si uložili (HTML alebo PDF); aj celý priečinok naraz; pri bytovom dome načíta aj byty a nebytové priestory s vchodom, poschodím, podielom a vlastníkmi |
+| `kataster_osoba_prehlad` | prehľad parciel a podielov jednej osoby zložený z náhľadov LV, ktoré ste si uložili; bez dotazu na portál |
+| `kataster_status` | verziu, limity a dnešné využitie kvóty |
+
+Vrstvy v `kataster_vrstvy`: bonitovaná pôdnoekologická jednotka (BPEJ), úradná hodnota pôdy, LPIS, užívateľ pôdy,
+záplavy, chránené územia, nadmorská výška, sklon terénu, zastavané územie obce, zakreslené ťarchy, pozemkové úpravy
+v katastrálnom území, les a siete (cesty, železnice, elektrické vedenia).
+
+Každá odpoveď uvádza zdroj, čas a to, či údaj prišiel z lokálnej cache. Neoficiálne rozhrania sú označené.
+
+## Čo zámerne nerobí
+
+- **Sám nehľadá podľa osoby.** Vlastníkov zistí len pre parcelu, ktorú zadáte. Ak chcete parcely konkrétnej osoby, vyhľadáte
+  ju sami v oficiálnom vyhľadávaní portálu ESKN („Fyzické osoby“), server vás tým prevedie a uložené náhľady listov
+  vlastníctva potom načíta a zloží do prehľadu.
+- **Nenahrádza súpis nehnuteľností podľa § 69 ods. 9 zákona č. 162/1995 Z. z.**, ktorý vydáva úrad len samotnej osobe.
+  Prehľad zložený z náhľadov je informatívny.
+- **Neprechádza celé katastrálne územia** kvôli vlastníkom.
+- **Neobchádza CAPTCHA.** Keď portál CAPTCHA vyžiada, alebo keď je denná kvóta vyčerpaná, server vám poradí presný ručný
+  postup v prehliadači a uložený výpis či náhľad potom načíta.
+- **Nezaťažuje portál.** Medzi dotazmi na kataster.skgeodesy.sk čaká aspoň 3 sekundy a nikdy sa nepýta paralelne.
+  Vlastníkov zistí najviac pre 50 parciel denne. Limity platia spoločne pre všetky spustené procesy (viac MCP klientov
+  aj príkazový riadok) a nedajú sa vypnúť nastavením ani zmenou dátového adresára.
+
+## Inštalácia
+
+Potrebujete [uv](https://docs.astral.sh/uv/getting-started/installation/) (Linux, macOS aj Windows). Server sa spúšťa
+ako lokálny proces cez stdio, takže ho pridáte do každého MCP klienta rovnako: príkaz `uvx` s argumentmi
+`--from git+https://github.com/braklo/kataster-mcp kataster-mcp`. Väčšina klientov to zapisuje do JSON konfigurácie
+v tomto tvare (presné miesto a názov kľúča nájdete v dokumentácii svojho klienta):
+
+```json
+{
+  "mcpServers": {
+    "kataster": {
+      "command": "uvx",
+      "args": ["--from", "git+https://github.com/braklo/kataster-mcp", "kataster-mcp"]
+    }
+  }
+}
+```
+
+Napríklad v Claude Code jedným príkazom:
+
+```bash
+claude mcp add kataster -- uvx --from git+https://github.com/braklo/kataster-mcp kataster-mcp
+```
+
+Potom sa stačí opýtať, napríklad: *„Čo je za pozemok E 503 v katastrálnom území Vyšný Kubín a kto ho vlastní?“*
+
+## Príkazový riadok
+
+Balík obsahuje aj príkaz `sk-kataster`. Bez inštalácie ho spustíte cez
+`uvx --from git+https://github.com/braklo/kataster-mcp sk-kataster`, výstup je JSON.
+
+```bash
+sk-kataster doctor
+sk-kataster ku resolve 'Vyšný Kubín'
+sk-kataster lv inspect ~/Stiahnuté/vypis.html
+sk-kataster lv import ~/Stiahnuté/vypis.html
+sk-kataster person overview --surname Novák --first-name Ján
+sk-kataster tools
+sk-kataster call kataster_parcela '{"ku": "Vyšný Kubín", "cislo": "E 503"}'
+```
+
+`doctor` ukáže verziu, adresáre a dnešné využitie kvóty. `ku`, `lv url`, `lv inspect`, `lv import` a
+`person overview` na portál nevolajú, `lv inspect` ani `lv import --dry-run` nič neukladajú. Výpis LV vracajú
+predvolene v súhrne; parcely a vlastníkov pridá `--full`. `tools` vypíše nástroje servera a `call` jeden z nich
+spustí. Ak nástroj ide na portál, platí rovnaká pauza a denný limit ako pre MCP server.
+
+Dátový adresár (cache a uložené LV) presuniete premennou `KATASTER_DATA_DIR`, v príkazovom riadku aj voľbou
+`--data-dir`. Stav limitov zostáva na pevnom mieste.
+
+Pre AI klientov, ktorí pracujú cez príkazový riadok, je v repozitári voliteľný návod
+[`skills/kataster/SKILL.md`](skills/kataster/SKILL.md).
+
+## Osobné údaje
+
+Mená, dátumy narodenia a adresy vlastníkov sa ukladajú len lokálne, do súboru `osoby.sqlite` v dátovom adresári
+servera, a po 7 dňoch sa pri ďalšom dotaze načítajú znova. Dátový adresár (presnú cestu vypíše `kataster_status`):
+
+| Systém | Adresár | Ochrana |
+|---|---|---|
+| Linux | `~/.local/share/kataster-mcp` (alebo `$XDG_DATA_HOME/kataster-mcp`) | práva 0700 / 0600 |
+| macOS | `~/Library/Application Support/kataster-mcp` | práva 0700 / 0600 |
+| Windows | `%LOCALAPPDATA%\kataster-mcp` | prístup len pre používateľa (predvolené nastavenie Windows) |
+
+Premenná `KATASTER_DATA_DIR` má prednosť pred týmito umiestneniami na všetkých troch systémoch a platí pre MCP server aj
+príkazový riadok.
+
+Denný limit dotazov na vlastníkov, pauza medzi dotazmi a blokácia po CAPTCHA sa evidujú zvlášť, v pevnom adresári, ktorý
+nemení žiadna premenná prostredia ani presun dátového adresára (presnú cestu vypíše `kataster_status` ako `limity_dir`):
+
+| Systém | Adresár limitov | Ochrana |
+|---|---|---|
+| Linux | `~/.local/state/kataster-mcp` | práva 0700 / 0600 |
+| macOS | `~/Library/Application Support/kataster-mcp-limits` | práva 0700 / 0600 |
+| Windows | `%USERPROFILE%\AppData\Local\kataster-mcp-limits` | prístup len pre používateľa (predvolené nastavenie Windows) |
+
+Server ich neposiela nikam inam než do odpovede vášmu AI asistentovi; ak model beží v cloude, dostane ich aj jeho
+poskytovateľ. Za to, ako ich použijete, zodpovedáte vy (GDPR, katastrálny zákon).
+
+## Zdroje dát
+
+Úrad geodézie, kartografie a katastra SR (INSPIRE, ESKN, ZBGIS, výškový model), Výskumný ústav pôdoznalectva a ochrany
+pôdy, Národné lesnícke centrum, Ministerstvo pôdohospodárstva a rozvoja vidieka SR, Slovenský vodohospodársky podnik,
+Štátna ochrana prírody SR. Podmienky ich použitia platia aj pri použití cez tento server; zdroj uvádzajte.
+
+## Stav
+
+Otestované s Claude Code na Linuxe. Na Windows a macOS prechádzajú automatické testy, v bežnom používaní
+to zatiaľ overené nie je; skúsenosti uvítame v issues.
+
+## Chyby a návrhy
+
+[Issues](https://github.com/braklo/kataster-mcp/issues), po slovensky aj po anglicky. Do issue nedávajte mená
+vlastníkov ani výpisy z listu vlastníctva.
+
+## Licencia
+
+Kód: [MIT](LICENSE). Licencia kódu sa nevzťahuje na údaje, ktoré server sprostredkúva.

kataster_mcp-0.3.0/README.md

@@ -0,0 +1,144 @@
+# kataster-mcp
+
+MCP server pre kataster nehnuteľností Slovenskej republiky. Umožňuje AI asistentovi alebo jazykovému modelu
+v ľubovoľnom klientovi s podporou [Model Context Protocol](https://modelcontextprotocol.io) zistiť o konkrétnom pozemku
+čo najviac z verejných zdrojov: hranice a výmeru parcely, list vlastníctva a vlastníkov,
+bonitu pôdy, úradnú hodnotu, LPIS, záplavové územia, ochranu prírody, les, sklon terénu, siete a mapu.
+
+*English: an MCP server for the Slovak land registry. An English README is in preparation.*
+
+Údaje majú informatívny charakter. Nie sú výpisom z listu vlastníctva a nedajú sa použiť na právne úkony.
+
+## Čo vie
+
+| Nástroj | Čo vráti |
+|---|---|
+| `kataster_ku` | katastrálne územie podľa názvu alebo kódu (obec, okres) |
+| `kataster_parcela` | parcelu registra C alebo E podľa čísla alebo súradníc: výmera, hranica, referenčný bod |
+| `kataster_vlastnici` | vlastníkov a podiely jednej zadanej parcely a číslo listu vlastníctva; na požiadanie (`detail_stavieb`) aj detail stavby na nej: LV stavby, druh a vlastníkov (každá stavba je ďalší dotaz do denného limitu; pri bytovom dome vlastníkov bytov nevracia, namiesto toho navedie, ako si uložiť a naimportovať list vlastníctva domu) |
+| `kataster_vrstvy` | tematické údaje o parcele (zoznam nižšie), pri plošných vrstvách aj podiel na výmere |
+| `kataster_skupina` | rozbor viacerých parciel: celková výmera, spoločné hranice, súvislé celky, susedia |
+| `kataster_mapa` | mapu parcely ako PNG, HTML (Leaflet), GeoJSON alebo KML, bez osobných údajov |
+| `kataster_lv` | odkaz na výpis z listu vlastníctva na portáli ESKN (výpis si otvoríte sami) |
+| `kataster_osoba_navod` | postup krok za krokom, ako si v oficiálnom vyhľadávaní portálu ESKN nájsť listy vlastníctva osoby a uložiť ich náhľady (server pri tom na portál nevolá) |
+| `kataster_lv_import` | načítanie výpisu LV alebo náhľadu LV, ktorý ste si uložili (HTML alebo PDF); aj celý priečinok naraz; pri bytovom dome načíta aj byty a nebytové priestory s vchodom, poschodím, podielom a vlastníkmi |
+| `kataster_osoba_prehlad` | prehľad parciel a podielov jednej osoby zložený z náhľadov LV, ktoré ste si uložili; bez dotazu na portál |
+| `kataster_status` | verziu, limity a dnešné využitie kvóty |
+
+Vrstvy v `kataster_vrstvy`: bonitovaná pôdnoekologická jednotka (BPEJ), úradná hodnota pôdy, LPIS, užívateľ pôdy,
+záplavy, chránené územia, nadmorská výška, sklon terénu, zastavané územie obce, zakreslené ťarchy, pozemkové úpravy
+v katastrálnom území, les a siete (cesty, železnice, elektrické vedenia).
+
+Každá odpoveď uvádza zdroj, čas a to, či údaj prišiel z lokálnej cache. Neoficiálne rozhrania sú označené.
+
+## Čo zámerne nerobí
+
+- **Sám nehľadá podľa osoby.** Vlastníkov zistí len pre parcelu, ktorú zadáte. Ak chcete parcely konkrétnej osoby, vyhľadáte
+  ju sami v oficiálnom vyhľadávaní portálu ESKN („Fyzické osoby“), server vás tým prevedie a uložené náhľady listov
+  vlastníctva potom načíta a zloží do prehľadu.
+- **Nenahrádza súpis nehnuteľností podľa § 69 ods. 9 zákona č. 162/1995 Z. z.**, ktorý vydáva úrad len samotnej osobe.
+  Prehľad zložený z náhľadov je informatívny.
+- **Neprechádza celé katastrálne územia** kvôli vlastníkom.
+- **Neobchádza CAPTCHA.** Keď portál CAPTCHA vyžiada, alebo keď je denná kvóta vyčerpaná, server vám poradí presný ručný
+  postup v prehliadači a uložený výpis či náhľad potom načíta.
+- **Nezaťažuje portál.** Medzi dotazmi na kataster.skgeodesy.sk čaká aspoň 3 sekundy a nikdy sa nepýta paralelne.
+  Vlastníkov zistí najviac pre 50 parciel denne. Limity platia spoločne pre všetky spustené procesy (viac MCP klientov
+  aj príkazový riadok) a nedajú sa vypnúť nastavením ani zmenou dátového adresára.
+
+## Inštalácia
+
+Potrebujete [uv](https://docs.astral.sh/uv/getting-started/installation/) (Linux, macOS aj Windows). Server sa spúšťa
+ako lokálny proces cez stdio, takže ho pridáte do každého MCP klienta rovnako: príkaz `uvx` s argumentmi
+`--from git+https://github.com/braklo/kataster-mcp kataster-mcp`. Väčšina klientov to zapisuje do JSON konfigurácie
+v tomto tvare (presné miesto a názov kľúča nájdete v dokumentácii svojho klienta):
+
+```json
+{
+  "mcpServers": {
+    "kataster": {
+      "command": "uvx",
+      "args": ["--from", "git+https://github.com/braklo/kataster-mcp", "kataster-mcp"]
+    }
+  }
+}
+```
+
+Napríklad v Claude Code jedným príkazom:
+
+```bash
+claude mcp add kataster -- uvx --from git+https://github.com/braklo/kataster-mcp kataster-mcp
+```
+
+Potom sa stačí opýtať, napríklad: *„Čo je za pozemok E 503 v katastrálnom území Vyšný Kubín a kto ho vlastní?“*
+
+## Príkazový riadok
+
+Balík obsahuje aj príkaz `sk-kataster`. Bez inštalácie ho spustíte cez
+`uvx --from git+https://github.com/braklo/kataster-mcp sk-kataster`, výstup je JSON.
+
+```bash
+sk-kataster doctor
+sk-kataster ku resolve 'Vyšný Kubín'
+sk-kataster lv inspect ~/Stiahnuté/vypis.html
+sk-kataster lv import ~/Stiahnuté/vypis.html
+sk-kataster person overview --surname Novák --first-name Ján
+sk-kataster tools
+sk-kataster call kataster_parcela '{"ku": "Vyšný Kubín", "cislo": "E 503"}'
+```
+
+`doctor` ukáže verziu, adresáre a dnešné využitie kvóty. `ku`, `lv url`, `lv inspect`, `lv import` a
+`person overview` na portál nevolajú, `lv inspect` ani `lv import --dry-run` nič neukladajú. Výpis LV vracajú
+predvolene v súhrne; parcely a vlastníkov pridá `--full`. `tools` vypíše nástroje servera a `call` jeden z nich
+spustí. Ak nástroj ide na portál, platí rovnaká pauza a denný limit ako pre MCP server.
+
+Dátový adresár (cache a uložené LV) presuniete premennou `KATASTER_DATA_DIR`, v príkazovom riadku aj voľbou
+`--data-dir`. Stav limitov zostáva na pevnom mieste.
+
+Pre AI klientov, ktorí pracujú cez príkazový riadok, je v repozitári voliteľný návod
+[`skills/kataster/SKILL.md`](skills/kataster/SKILL.md).
+
+## Osobné údaje
+
+Mená, dátumy narodenia a adresy vlastníkov sa ukladajú len lokálne, do súboru `osoby.sqlite` v dátovom adresári
+servera, a po 7 dňoch sa pri ďalšom dotaze načítajú znova. Dátový adresár (presnú cestu vypíše `kataster_status`):
+
+| Systém | Adresár | Ochrana |
+|---|---|---|
+| Linux | `~/.local/share/kataster-mcp` (alebo `$XDG_DATA_HOME/kataster-mcp`) | práva 0700 / 0600 |
+| macOS | `~/Library/Application Support/kataster-mcp` | práva 0700 / 0600 |
+| Windows | `%LOCALAPPDATA%\kataster-mcp` | prístup len pre používateľa (predvolené nastavenie Windows) |
+
+Premenná `KATASTER_DATA_DIR` má prednosť pred týmito umiestneniami na všetkých troch systémoch a platí pre MCP server aj
+príkazový riadok.
+
+Denný limit dotazov na vlastníkov, pauza medzi dotazmi a blokácia po CAPTCHA sa evidujú zvlášť, v pevnom adresári, ktorý
+nemení žiadna premenná prostredia ani presun dátového adresára (presnú cestu vypíše `kataster_status` ako `limity_dir`):
+
+| Systém | Adresár limitov | Ochrana |
+|---|---|---|
+| Linux | `~/.local/state/kataster-mcp` | práva 0700 / 0600 |
+| macOS | `~/Library/Application Support/kataster-mcp-limits` | práva 0700 / 0600 |
+| Windows | `%USERPROFILE%\AppData\Local\kataster-mcp-limits` | prístup len pre používateľa (predvolené nastavenie Windows) |
+
+Server ich neposiela nikam inam než do odpovede vášmu AI asistentovi; ak model beží v cloude, dostane ich aj jeho
+poskytovateľ. Za to, ako ich použijete, zodpovedáte vy (GDPR, katastrálny zákon).
+
+## Zdroje dát
+
+Úrad geodézie, kartografie a katastra SR (INSPIRE, ESKN, ZBGIS, výškový model), Výskumný ústav pôdoznalectva a ochrany
+pôdy, Národné lesnícke centrum, Ministerstvo pôdohospodárstva a rozvoja vidieka SR, Slovenský vodohospodársky podnik,
+Štátna ochrana prírody SR. Podmienky ich použitia platia aj pri použití cez tento server; zdroj uvádzajte.
+
+## Stav
+
+Otestované s Claude Code na Linuxe. Na Windows a macOS prechádzajú automatické testy, v bežnom používaní
+to zatiaľ overené nie je; skúsenosti uvítame v issues.
+
+## Chyby a návrhy
+
+[Issues](https://github.com/braklo/kataster-mcp/issues), po slovensky aj po anglicky. Do issue nedávajte mená
+vlastníkov ani výpisy z listu vlastníctva.
+
+## Licencia
+
+Kód: [MIT](LICENSE). Licencia kódu sa nevzťahuje na údaje, ktoré server sprostredkúva.

kataster_mcp-0.3.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "kataster-mcp"
+version = "0.3.0"
+description = "MCP server for the Slovak land registry (kataster nehnuteľností SR): parcels, LV, owners, soil, LPIS, floods, nature protection, maps"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Branislav Klocok", email = "branislav.klocok@orava.sk" }]
+keywords = ["kataster", "slovakia", "cadastre", "mcp"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: Slovak",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: GIS",
+]
+dependencies = [
+    "mcp[cli]>=2.3,<3",
+    "httpx>=0.27.0",
+    "shapely>=2.2.0",
+    "pillow>=12.3.0",
+    "pypdf>=6.19.0",
+    "tzdata>=2026.5 ; sys_platform == 'win32'",
+]
+
+[project.urls]
+Homepage = "https://github.com/braklo/kataster-mcp"
+Issues = "https://github.com/braklo/kataster-mcp/issues"
+
+[project.scripts]
+kataster-mcp = "kataster_mcp.server:main"
+sk-kataster = "kataster_mcp.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+# Allowlist for the source distribution.
+[tool.hatch.build.targets.sdist]
+only-include = ["src", "tests", "LICENSE", "README.md", "pyproject.toml"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/kataster_mcp"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["live: hits real public endpoints (run by hand, human pace)"]
+addopts = "-m 'not live'"

kataster_mcp-0.3.0/src/kataster_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""MCP server for the Slovak land registry."""
+
+__version__ = "0.3.0"

kataster_mcp-0.3.0/src/kataster_mcp/cache.py

@@ -0,0 +1,232 @@
+"""Local SQLite cache and the daily owners quota.
+
+Two files under the data dir (0700):
+- cache.sqlite  public data (geometry, layers)
+- osoby.sqlite  personal data (owners, land users), always 0600
+and the state of the limits in a fixed per-user directory (default_limits_dir):
+- stav.sqlite   the daily owners quota and a portal block, 0600
+- tempo/        one file per host with the time of its last request (pacing.Pacer)
+
+Every entry is keyed by (source, parser version, key). The parser version is a hash
+of the parser's source code, so fixing a parser silently invalidates old entries.
+"""
+
+import hashlib
+import inspect
+import json
+import os
+import sqlite3
+import sys
+import time
+from datetime import datetime
+from pathlib import Path
+from zoneinfo import ZoneInfo
+
+# Owner-only file permissions exist only on POSIX; on Windows chmod just toggles the read-only flag and the
+# data directory under %LOCALAPPDATA% is protected by the user profile's ACL instead.
+POSIX = os.name == "posix"
+
+
+TZ = ZoneInfo("Europe/Bratislava")  # on Windows from the tzdata package (a dependency there)
+
+DAY = 86400
+
+
+def default_data_dir(platform: str | None = None, env: dict | None = None) -> Path:
+    """Per-user data directory: Windows %LOCALAPPDATA%, macOS ~/Library/Application Support,
+    elsewhere $XDG_DATA_HOME or ~/.local/share."""
+    platform = platform or sys.platform
+    env = os.environ if env is None else env
+    if platform == "win32":
+        base = env.get("LOCALAPPDATA") or os.path.join(Path.home(), "AppData", "Local")
+    elif platform == "darwin":
+        base = os.path.join(Path.home(), "Library", "Application Support")
+    else:
+        base = env.get("XDG_DATA_HOME") or os.path.join(Path.home(), ".local", "share")
+    return Path(base) / "kataster-mcp"
+
+
+def configured_data_dir() -> Path:
+    """Data directory (cache, imports, snapshots): KATASTER_DATA_DIR when set, else default_data_dir().
+    It never moves the limits (default_limits_dir)."""
+    configured = os.environ.get("KATASTER_DATA_DIR")
+    return Path(configured).expanduser() if configured else default_data_dir()
+
+
+def default_limits_dir(platform: str | None = None) -> Path:
+    """Fixed per-user directory for the state of the limits (daily owners quota, pause across processes, portal
+    block). Unlike the data directory it follows no environment variable or configuration:
+    another data directory or XDG_DATA_HOME must not mean a new quota. Linux and others ~/.local/state/kataster-mcp,
+    macOS ~/Library/Application Support/kataster-mcp-limits, Windows <profile>\\AppData\\Local\\kataster-mcp-limits."""
+    platform = platform or sys.platform
+    home = _home()
+    if platform == "win32":
+        return home / "AppData" / "Local" / "kataster-mcp-limits"
+    if platform == "darwin":
+        return home / "Library" / "Application Support" / "kataster-mcp-limits"
+    return home / ".local" / "state" / "kataster-mcp"
+
+
+def _home() -> Path:
+    """Home directory from the account database on POSIX (not $HOME), the user profile on Windows."""
+    try:
+        import pwd
+        return Path(pwd.getpwuid(os.getuid()).pw_dir)
+    except (ImportError, KeyError, AttributeError):
+        return Path.home()
+
+
+# os.open() on Windows opens the C runtime descriptor in text mode unless O_BINARY is given (0 on POSIX).
+O_BINARY = getattr(os, "O_BINARY", 0)
+
+
+def restrict(path, mode: int) -> None:
+    """chmod where it means something (POSIX); a no-op elsewhere, never an error."""
+    if POSIX:
+        os.chmod(path, mode)
+
+
+def protection() -> str:
+    return ("owner only (0700 directory, 0600 personal-data files)" if POSIX
+            else "user profile ACL of the data directory (no POSIX permissions on this OS)")
+
+
+def parser_version(*funcs) -> str:
+    h = hashlib.sha256()
+    for f in funcs:
+        h.update(inspect.getsource(f).encode())
+    return h.hexdigest()[:12]
+
+
+def today() -> str:
+    return datetime.now(TZ).date().isoformat()
+
+
+def next_day_iso() -> str:
+    """Midnight starting the next calendar day in Bratislava (when the daily quota resets)."""
+    from datetime import timedelta
+
+    d = datetime.now(TZ).date() + timedelta(days=1)
+    return datetime(d.year, d.month, d.day, tzinfo=TZ).isoformat(timespec="seconds")
+
+
+def _ensure_private_file(path: Path) -> None:
+    if not path.exists():
+        os.close(os.open(path, os.O_CREAT | os.O_WRONLY | O_BINARY, 0o600))
+    restrict(path, 0o600)
+
+
+PERSONAL_TTL = 7 * DAY  # personal data (owners, imported LVs, page snapshots) is deleted after this
+
+
+def purge_files(directory: Path, max_age_s: float) -> int:
+    """Delete files older than max_age_s (by modification time); returns how many."""
+    if not directory.is_dir():
+        return 0
+    limit = time.time() - max_age_s
+    n = 0
+    for f in directory.iterdir():
+        try:
+            if f.is_file() and f.stat().st_mtime < limit:
+                f.unlink()
+                n += 1
+        except OSError:
+            pass
+    return n
+
+
+class Cache:
+    """SQLite cache. With max_age_s (personal data) rows older than that are physically deleted when the
+    cache opens (then VACUUM) and after every write; freed pages are overwritten (secure_delete)."""
+
+    def __init__(self, path: Path, *, private: bool, max_age_s: float | None = None):
+        path.parent.mkdir(parents=True, exist_ok=True)
+        restrict(path.parent, 0o700)
+        if private:
+            _ensure_private_file(path)
+        self.path = path
+        self.max_age_s = max_age_s
+        self.db = sqlite3.connect(path, check_same_thread=False)
+        if max_age_s is not None:
+            self.db.execute("PRAGMA secure_delete=ON")
+        self.db.execute(
+            "CREATE TABLE IF NOT EXISTS cache (zdroj TEXT, ver TEXT, kluc TEXT, ulozene REAL, data TEXT,"
+            " PRIMARY KEY (zdroj, ver, kluc))"
+        )
+        self.db.commit()
+        if max_age_s is not None and self.purge():
+            self.db.execute("VACUUM")
+
+    def purge(self) -> int:
+        """Delete rows older than max_age_s, whatever their source or version; returns how many."""
+        if self.max_age_s is None:
+            return 0
+        n = self.db.execute("DELETE FROM cache WHERE ulozene < ?", (time.time() - self.max_age_s,)).rowcount
+        self.db.commit()
+        return n
+
+    def get(self, zdroj: str, ver: str, kluc: str, ttl_s: float | None):
+        row = self.db.execute(
+            "SELECT data, ulozene FROM cache WHERE zdroj=? AND ver=? AND kluc=?", (zdroj, ver, kluc)
+        ).fetchone()
+        if row is None:
+            return None
+        data, ulozene = row
+        if ttl_s is not None and time.time() - ulozene > ttl_s:
+            return None
+        return json.loads(data), ulozene
+
+    def put(self, zdroj: str, ver: str, kluc: str, data) -> float:
+        ts = time.time()
+        self.db.execute(
+            "INSERT OR REPLACE INTO cache VALUES (?, ?, ?, ?, ?)",
+            (zdroj, ver, kluc, ts, json.dumps(data, ensure_ascii=False)),
+        )
+        self.db.commit()
+        self.purge()
+        return ts
+
+    def stats(self) -> dict:
+        rows = self.db.execute("SELECT zdroj, ver, COUNT(*) FROM cache GROUP BY zdroj, ver").fetchall()
+        return {f"{z}@{v}": n for z, v, n in rows}
+
+
+class Quota:
+    """Parcels per calendar day whose owners were fetched from the portal."""
+
+    def __init__(self, db: sqlite3.Connection):
+        self.db = db
+        db.execute("CREATE TABLE IF NOT EXISTS kvota (den TEXT, parcela TEXT, PRIMARY KEY (den, parcela))")
+        db.commit()
+
+    def merge_today(self, old: Path) -> int:
+        """Add today's rows of a quota kept elsewhere before (the data directory); the union is never laxer."""
+        if not old.exists():
+            return 0
+        src = sqlite3.connect(f"file:{old}?mode=ro", uri=True)
+        try:
+            rows = src.execute("SELECT den, parcela FROM kvota WHERE den=?", (today(),)).fetchall()
+        except sqlite3.OperationalError:  # no quota table there
+            rows = []
+        finally:
+            src.close()
+        before = self.used()
+        self.db.executemany("INSERT OR IGNORE INTO kvota VALUES (?, ?)", rows)
+        self.db.commit()
+        return self.used() - before
+
+    def used(self, den: str | None = None) -> int:
+        return self.db.execute("SELECT COUNT(*) FROM kvota WHERE den=?", (den or today(),)).fetchone()[0]
+
+    def counted(self, parcela: str, den: str | None = None) -> bool:
+        return self.db.execute(
+            "SELECT 1 FROM kvota WHERE den=? AND parcela=?", (den or today(), parcela)
+        ).fetchone() is not None
+
+    def record(self, parcela: str, den: str | None = None) -> None:
+        self.db.execute("INSERT OR IGNORE INTO kvota VALUES (?, ?)", (den or today(), parcela))
+        self.db.commit()
+
+
+def ts_iso(ts: float) -> str:
+    return datetime.fromtimestamp(ts, TZ).isoformat(timespec="seconds")