O projektu a architektuře
PgArachne™ slouží jako lehký, vysoce výkonný webový server, který stojí mezi vašimi HTTP klienty a databází PostgreSQL. Eliminuje potřebu tradičních backendových jazyků (jako Python, Node.js nebo PHP) tím, že mapuje HTTP požadavky přímo na databázové funkce.
Klíčové technické schopnosti
- Brána JSON-RPC 2.0: Veškeré interakce s API se řídí striktní specifikací JSON-RPC 2.0. Nemusíte navrhovat žádné REST endpointy; jednoduše voláte SQL funkce jménem pomocí POST požadavků.
- Nativní DB autentizace: Žádné oddělené tabulky uživatelů. Uživatelé se přihlašují svými skutečnými PostgreSQL přihlašovacími údaji a získají JWT. Služby mohou alternativně využívat trvalé API Tokeny.
- Maskování rolí (Role Masquerading): PgArachne™ se připojuje jako proxy uživatel,
ale každý požadavek provádí pomocí
SET LOCAL ROLE, čímž se přepne do identity ověřeného uživatele. Zabezpečení na úrovni řádků (RLS) funguje automaticky. - MCP (Model Context Protocol): Nativní MCP endpoint umožňuje AI klientům jako Claude Desktop, Cursor a dalším MCP-kompatibilním nástrojům přímo objevovat vaše PostgreSQL funkce jako nástroje a volat je — bez jediného řádku propojovacího kódu. Platí stejná autentizace a zabezpečení rolí. Přes MCP jsou vystaveny také zdroje (tabulky/views) a šablony promptů.
- Real-time notifikace (SSE): Odebírejte PostgreSQL
NOTIFYkanály přes SSE pro živé aktualizace bez pollingu. - Server statických souborů: PgArachne™ může servírovat statické assety (HTML, JS, CSS), což vám umožní hostovat Single Page Aplikace (SPA) nebo přímo nástroj Explorer.
Tato architektura dramaticky zjednodušuje stack: Databáze ↔ PgArachne ↔ Frontend/AI Agent.
Struktura endpointů: Všechny databázové endpointy sdílejí společný prefix (výchozí
db, konfigurovatelný přes API_PREFIX):POST /{prefix}/{databaze}/jsonrpc — brána JSON-RPC 2.0
GET /{prefix}/{databaze}/sse — stream PostgreSQL NOTIFY
POST /{prefix}/{databaze}/mcp — Model Context Protocol