z3950-gateway

MCP server pro hledání v knihovních katalozích přes Z39.50 (SVK PK, NK ČR, národní autority). Určeno pro katalogizátory SVK PK a jejich práci s Claudem.

Adresa MCP (Streamable HTTP): https://z3950-gateway.k8s.svkpk.cz/mcp

Přístup je jen s tokenem v hlavičce Authorization: Bearer <TOKEN>. Token přiděluje správce služby; na této stránce žádný není.

Připojení

Claude Code

claude mcp add --transport http z3950 https://z3950-gateway.k8s.svkpk.cz/mcp \
  --header "Authorization: Bearer <TOKEN>"

Soubor .mcp.json

{
  "mcpServers": {
    "z3950": {
      "type": "http",
      "url": "https://z3950-gateway.k8s.svkpk.cz/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Konektor Claude

Vlastní konektor s adresou https://z3950-gateway.k8s.svkpk.cz/mcp a hlavičkou požadavku Authorization: Bearer <TOKEN> (hlavičky požadavku u konektorů jsou zatím ve zkušebním provozu).

VS Code (.vscode/mcp.json)

{
  "servers": {
    "z3950": {
      "type": "http",
      "url": "https://z3950-gateway.k8s.svkpk.cz/mcp",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Ověření

curl -fsS https://z3950-gateway.k8s.svkpk.cz/healthz
curl -sS -X POST https://z3950-gateway.k8s.svkpk.cz/mcp \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Nástroje

NástrojPopis
z3950_list_targetsVypíše dostupné Z39.50/SRU cíle definované v targets.yaml a jejich pole.
z3950_searchHledá v knihovním katalogu podle pojmenovaných polí spojených přes AND.
z3950_search_cqlPošle přímý CQL dotaz na cíl — pro nestandardní případy (OR, relace adj).
z3950_scanVypíše úsek rejstříku hesel (Scan) od zadaného místa – nehledá záznamy.
z3950_holdingsVypíše jednotky (exempláře) jednoho záznamu: signaturu, čárový kód a dostupnost.

Cíle

KlíčKatalogBáze
nkcNK ČR — hlavní katalog (NKC)NKC
cnbČeská národní bibliografie (CNB)CNB
skcSouborný katalog ČR — vše (SKC)SKC
skcmSouborný katalog ČR — monografie (SKCM)SKCM
skcpSouborný katalog ČR — seriály (SKCP)SKCP
autNárodní autority (AUT) — jiné indexy než biblio bázeAUT
anlČlánky (ANL) — zdrojový dokument (use 1033)ANL
slkSlovanská knihovna (SLK)SLK
sttStaré tisky (STT) — JEN NEKOMERČNÍ, omezené indexySTT
kklKnihovnická literatura (KKL) — JEN NEKOMERČNÍKKL
svkpkSVK PK — celý katalog (PNA01)PNA01
svkpk-clankySVK PK — regionální časopisecké články (PNA02)PNA02
svkpk-osobnostiSVK PK — regionální osobnosti (PNA04)PNA04
svkpk-allSVK PK — katalog, veřejná báze (PNAAL), výchozíPNAAL