mcp-nsa

MCP server dla orzecznictwa polskich sądów administracyjnych (NSA + 16 WSA) przez CBOSA — Centralną Bazę Orzeczeń Sądów Administracyjnych (orzeczenia.nsa.gov.pl).

Po co

SAOS (System Analizy Orzeczeń Sądowych) nie indeksuje sądów administracyjnych. A to właśnie tam żyje merytoryczne orzecznictwo:

• RODO / ochrona danych — decyzje Prezesa UODO zaskarżane do WSA, kasacje do NSA
• Podatki — interpretacje indywidualne, decyzje organów podatkowych
• Cła i akcyza
• Zezwolenia administracyjne, koncesje
• Kontrola działalności administracji publicznej

mcp-nsa zamyka tę lukę. Pokrycie: 427 000+ orzeczeń, od 2004 do dziś.

Tooly

• search(query, caseNumber?, court?, dateFrom?, dateTo?, pageSize?, pageNumber?) — wyszukiwanie po słowach, sygnaturze, sądzie, dacie. Pobiera top-5 pełnych orzeczeń (sygnatura, sąd, data, skład, hasła, podst. prawna, fragment).
• get_judgment(doc_id) — pełne orzeczenie po 10-znakowym hex doc_id (z URL CBOSA, np. 7E50984BB7).
• search_by_case(caseNumber) — skrót: szukaj po sygnaturze (np. III OSK 1377/23, I SA/Gl 659/22).

Każda zwrotka zawiera structuredContent.citations z polami: title, url (CBOSA), case_number, court, judgment_date, decision_type, snippet, doc_id. Patron czyta to pole automatycznie i wystawia w panelu UI jako sekcję "Orzeczenia z CBOSA (NSA / WSA — sądy administracyjne)".

Stack

• Node 18+
• @modelcontextprotocol/sdk
• Stdio transport
• https + regex HTML parser (zero zewnętrznych dep poza SDK)
• Throttle 500 ms między żądaniami (2 req/s)
• SSL: rejectUnauthorized: false — chain CBOSA bywa niekompletny na niektórych maszynach; publiczne orzeczenia, bez PII, ryzyko MITM znikome wobec korzyści. Patrz: LDH issue #167.

Build + uruchomienie

npm install
npm run build
node dist/index.js   # uruchomi serwer na stdio

Wpięcie do Patrona

W patron/backend/mcp-servers.json (równolegle do mcp-saos i mcp-eu-sparql):

{
  "name": "nsa",
  "transport": "stdio",
  "command": "node",
  "args": ["C:/Users/<TWOJ-UZYTKOWNIK>/mcp-nsa/dist/index.js"],
  "enabled": true
}

Smoke test

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"s","version":"0"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{"query":"RODO art 6","pageSize":10}}}' \
  | node dist/index.js

Powinno zwrócić ~1500 trafień + top-5 z polskimi sygnaturami NSA/WSA + URL CBOSA

• structuredContent.citations.

Lineage

Implementacja przepisana do TypeScript na bazie kontraktu HTTP/HTML z legal-data-hunter/sources/PL/NSA (Python + BeautifulSoup, MIT). Nie importuje kodu źródłowego — odtwarza wzorzec zapytań i parsowanie HTML.

Licencja

MIT.

Part of the MateMatic legal stack

This server is one of five MCP connectors covering Polish jurisdiction + EU law, used by Patron (AGPL-3.0) and any other MCP-aware legal AI agent.

• mcp-nsa (this repo) — NSA + 16 WSA administrative courts (CBOSA)
• mcp-saos — common courts, SN, TK, KIO
• mcp-isap — Polish legislation (Dz.U. + M.P.)
• mcp-krs — Polish company registry (KRS)
• mcp-eu-sparql — EU law + CJEU (EUR-Lex)

All five MCP servers share the same structuredContent.citations contract: each tool returns an array of {title, url, snippet?, ...metadata} that legal agents can render directly in their citation panel.

See matematicsolutions/.github for the full org profile.