Skip to main content
Glama

Datovka Multibox

Česky | English

K čemu je projekt dobrý

Datovka Multibox propojuje AI asistenta s několika českými datovými schránkami. Pomáhá vyřizovat osobní i firemní korespondenci: vybrat správný účet, načíst zprávy, najít příjemce a připravit odpověď s přílohami. Odesílání vyžaduje kontrolu konkrétního návrhu v místním okně. Přístup máte pouze přes vlastní nastavené účty a jejich oprávnění.

Veřejná část slouží ke sdílení programu. Soukromá část je místní instalace s vašimi účty, oprávněními a návrhy. Obě používají stejné jádro, takže opravy není nutné udržovat dvakrát. Účty a hesla nejsou součástí veřejného repozitáře.

Related MCP server: mcp-server-datovka

Podpora vývoje

Moje úpravy a údržbu této odvozené verze můžete dobrovolně podpořit na Buy Me a Coffee. Příspěvek není podmínkou používání. Původní projekt vytvořilo Sensio.cz; odkaz podporuje tuto odvozenou verzi.

Místní MCP konektor pro více českých datových schránek. Odvozeno z projektu Sensio-cz/mcp-datovka, viz UPSTREAM.md.

Verze 0.2.0 je základ připravený pro doplnění vlastních účtů. Offline testy ověřují ochrany a sestavení SOAP požadavků. Funkčnost s opravdovými schránkami zatím nebyla ověřena. Před ostrým provozem proveďte zkoušku v testovacím ISDS.

Veřejná a soukromá varianta

Veřejná část je tento repozitář: zdrojový kód, plugin, testy a vzor konfigurace. Soukromá varianta používá stejné jádro s místním nastavením. Nevzniká druhá větev s hesly, kterou by bylo možné omylem sloučit do veřejné verze.

Na Windows jsou účty a návrhy standardně v %LOCALAPPDATA%\DatovkaMultibox. Na ostatních systémech v ~/.local/share/DatovkaMultibox. Umístění lze změnit absolutní cestou v DATOVKA_PRIVATE_DIR; musí být mimo repozitář. Hesla ukládá knihovna keyring do systémového úložiště (na Windows Credential Manager). Hesla nejsou v JSON, argumentech nástrojů ani v konfiguraci MCP. Soubor config.example.json obsahuje pouze smyšlený příklad.

Instalace na Windows

Potřebujete Python 3.11 nebo novější. V kořeni projektu spusťte:

./scripts/install.ps1
./scripts/nastavit-ucet.ps1

První příkaz vytvoří oddělené .venv a prázdnou soukromou konfiguraci. Druhý interaktivně přidá účet; lze ho opakovat pro další schránky. Heslo se zadává skrytě v místním terminálu. Testovací prostředí je výchozí, produkční se volí výslovně. Příjem i odesílání se povolují zvlášť. Přidání účtu se nepřipojuje k ISDS a není ověřením správnosti přihlašovacích údajů.

Současná verze podporuje jméno a heslo ISDS. Bankovní identita, Mobilní klíč, SMS a certifikát v této verzi implementované nejsou. Neměňte si kvůli tomu bez rozmyslu nastavení zabezpečení účtu.

Připojení k AI klientovi

Balíček obsahuje kompatibilní manifest .codex-plugin/plugin.json, .mcp.json a dovednost v skills/. Po instalaci závislostí lze kořen projektu přidat jako místní plugin. Instalace uloží cestu k běhovému prostředí do soukromého runtime.json, aby fungovala i kopie pluginu v mezipaměti klienta. Samotné zveřejnění na GitHubu jej nenainstaluje do Codexu ani nezveřejní v katalogu OpenAI.

V Codex CLI lze po instalaci závislostí zaregistrovat repozitář a plugin:

codex plugin marketplace add petrkosekmb-commits/mcp-datovka-multibox
codex plugin add datovka-multibox@datovka-multibox-community

Po instalaci otevřete nový chat. Při aktualizaci kódu zopakujte také scripts/install.ps1, aby se aktualizovalo místní běhové prostředí.

Pro běžného MCP klienta použijte absolutní cestu k .venv/Scripts/python.exe (Windows), argumenty -m mcp_datovka a stdio. Soukromá data nejsou součástí pluginu. Na Linuxu vytvořte .venv pomocí python3 -m venv .venv, instalujte .venv/bin/python -m pip install . a zajistěte funkční systémové úložiště hesel a Tk pro kontrolní okno.

Práce se schránkami

  • datovka_list_boxes: místní seznam účtů bez sítě.

  • datovka_list_received, datovka_list_sent: seznamy z výslovně zvolené schránky.

  • datovka_read_message: stažení přijaté zprávy včetně příloh v base64.

  • datovka_search_box: hledání příjemce přes zvolený účet.

  • datovka_prepare_message: místní neměnný návrh, bez odeslání.

  • datovka_get_draft: celý text, odesílatel, příjemce, přílohy a stav.

  • datovka_send_draft: jediný pokus o odeslání schváleného návrhu.

U příloh lze do JSON pole files zadat buď file_path s absolutní cestou, nebo filename, mime_type a content_base64. Při přípravě se obsah uloží do návrhu; pozdější změna původního souboru odesílaný návrh nezmění. Text je příloha text-zpravy.txt, i když zpráva obsahuje další soubory. Místní limit je 20 MiB a 50 přidaných příloh, nikoli tvrzení o limitu ISDS.

Kontrola a odeslání

  1. Připravte návrh a zkontrolujte schránku, prostředí, ID příjemce a obsah.

  2. Otevřete místní kontrolní okno:

    ./.venv/Scripts/python.exe -m mcp_datovka.setup review ID_NAVRHU
  3. Uživatel v okně schválí konkrétní návrh. Schválení samo nic neodesílá.

  4. AI může zavolat datovka_send_draft pouze s ID schváleného návrhu.

Návrh čeká na schválení nejvýše 24 hodin; po schválení platí 15 minut. Odesílatel je svázán s ID schránky, přihlašovacím jménem a prostředím. Před odesláním se přes ISDS kontroluje, zda přihlášení odpovídá ID schránky. Jakákoli změna obsahu vyžaduje nový návrh a nové schválení.

Stav sent znamená, že ISDS vrátilo ID zprávy; není to potvrzení jejího doručení adresátovi. sending po pádu procesu a uncertain po chybě vyžadují ruční kontrolu odeslaných zpráv. Automatický druhý pokus je blokován. Záměrně tu není nástroj MCP pro schválení. Jde o ochranu na hranici MCP, nikoli proti programu se stejnými plnými právy k místním souborům a klávesnici.

Doručení a soukromí

Načtení příchozích zpráv může způsobit doručení a běh lhůt. Vypnuté odesílání tomu samo nebrání. Příjem se proto povoluje zvlášť. Není tu automatický plánovač synchronizace. Viz příručka Datovky.

Návrhy a jejich přílohy jsou v místní SQLite databázi bez aplikačního šifrování; chraňte uživatelský profil a disk. Hesla jsou v systémovém úložišti zvlášť. Obsah vrácený MCP klientovi může být odeslán jeho poskytovateli AI podle nastavení klienta. Místní server sám neznamená, že obsah zůstává pouze v PC. Archivace ZFO, doručenek a zálohování na NAS zatím nejsou implementované.

Vývoj a ověření

./.venv/Scripts/python.exe -m pip install pytest build
./.venv/Scripts/python.exe -m pytest -q
./.venv/Scripts/python.exe -m build --wheel

Testy používají smyšlené účty a blokují síťové požadavky. Ověřují výběr účtu, povolování příjmu, neměnnost návrhu, expiraci, souběh, blokování opakovaného odeslání, chyby ISDS a skládání příloh. CI běží na Windows a Linuxu.

Licence původního kódu: MIT, viz LICENSE. Původ převzatých definic WSDL/XSD a odlišné licence závislostí jsou uvedeny v UPSTREAM.md.

Available Tools

8 tools
datovka_get_draftB
Read-only

Vrati uplny text, hashe priloh a stav navrhu bez site.

Inputs: draft_id (required).

datovka_list_boxesA
Read-only

Mistni seznam uctu bez pripojeni k ISDS a bez prihlasovacich udaju.

Inputs: no named parameters. Returns: result

datovka_list_receivedB
Destructive

Nacte prijate zpravy. Muze zpusobit doruceni; vyzaduje povoleny prijem.

Inputs: box_alias (required), from_date, max_results. Returns: result

datovka_list_sentC
Destructive

Nacte odeslane zpravy z vybraneho uctu. Vyzaduje povoleny sitovy prijem.

Inputs: box_alias (required), from_date, max_results. Returns: result

datovka_prepare_messageA

Ulozi nemenny navrh lokalne; nic neodesila. files je JSON pole priloh.

Zobrazte uplny nahled. Schvaleni pouze v mistnim okne prikazem datovka-config review ID. Nevydavejte pripravu za odeslani.

Inputs: subject (required), to_box_id (required), from_box_alias (required), body, +1 more.

datovka_read_messageB
Destructive

Stahne prijatou zpravu s prilohami base64; muze zpusobit doruceni.

Inputs: box_alias (required), message_id (required).

datovka_send_draftA
Destructive

Odesle pouze lokalne schvaleny nemenny navrh, nejvyse jeden pokus.

Po chybe nejprve overte odeslane zpravy. Nevytvarejte automaticky novy navrh pro opakovani. Schvaleni nema MCP nastroj.

Inputs: draft_id (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 8 tools

    Disambiguation4/5

    The read path (list_boxes, list_received, list_sent, read_message) and the write path (prepare_message, get_draft, send_draft) are cleanly separated, and the immutability/approval semantics are spelled out. The only real overlap is datovka_search_box versus datovka_list_boxes, which an agent could confuse since both concern data boxes; the descriptions disambiguate but require careful reading.

    Naming Consistency5/5

    Every tool uses the datovka_ prefix with a consistent snake_case verb_noun pattern (list_received, read_message, prepare_message, send_draft, get_draft). The verb choices map predictably to action semantics: list for collections, get for a single known artifact, read for content retrieval.

    Tool Count5/5

    Eight tools is well-scoped for a mail/data-box client, with each tool covering a distinct step in the receive-compose-approve-send workflow. Nothing looks redundant, and the split between prepare_message, get_draft, and send_draft is justified by the immutable-draft design.

    Completeness3/5

    Core lifecycle is covered for received mail and for outgoing drafts, but the surface has notable gaps: sent messages can be listed yet never read in full (read_message is receive-only), there is no way to delete or discard a draft, and no message-level search or attachment enumeration beyond reading a message. Approval being outside MCP is a deliberate design choice rather than a gap, but the read side of outbound mail remains a dead end.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Provides secure, draft-first IMAP/SMTP access to a GMX business mailbox over Streamable HTTP, letting users list folders, read, search and download attachments, and create, update or delete drafts and replies. Sending is never arbitrary: it requires an explicit user-approved send of a previously reviewed draft, and email content is always treated as untrusted data.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching, reading, sending, replying to, forwarding, and organizing email across multiple SMTP/IMAP accounts.
      MIT