Supports containerized deployment of the MCP server using Docker for consistent runtime environments.
Supports pushing code to GitHub repositories as part of the deployment workflow for remote hosting on Render.
Enables deployment of the MCP server as a web service on Render's platform, providing remote access to KB (Kungliga biblioteket) APIs through HTTP/SSE endpoints.
Allows exporting bibliographic data from KB's Libris and Swepub APIs in formats compatible with Zotero reference management, including RIS format export for author and subject bibliographies.
KB MCP Server
MCP-server för åtkomst till Kungliga bibliotekets öppna API:er - Sveriges nationella biblioteksdata, kulturarv, forskning och länkad data.
📊 Översikt
Datakälla | Beskrivning | Antal poster |
Libris | Bibliografiska poster | 20M+ |
K-samsök | Kulturarvsobjekt | 10M+ |
Swepub | Forskningspublikationer | 2M+ |
id.kb.se | Auktoriteter & vokabulär | 500K+ |
52 verktyg fördelade på 10 API-endpoints.
🚀 Installation
Lokal installation (Claude Desktop, Claude Code)
Claude Desktop-konfiguration
Lägg till i ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) eller motsvarande:
Starta om Claude Desktop.
Remote deployment (Render)
Push till GitHub
Skapa ny Web Service på Render:
Välj repository
Build Command:
pip install -r requirements.txtStart Command:
python kb_mcp_server.py --http --port $PORT
Hämta URL:
https://your-service.onrender.com
Alternativt, använd Blueprint:
Docker
🔧 Verktyg per Endpoint
1. Libris Xsearch (5 verktyg)
Enkel bibliotekssökning med 20M+ poster.
Verktyg | Beskrivning |
| Fritextsökning |
| Sök efter författare |
| Sök efter titel |
| Sök efter ämne |
| Sök efter ISBN |
2. Libris XL REST (6 verktyg)
Avancerad åtkomst till bibliografisk data.
Verktyg | Beskrivning |
| Hämta specifik post |
| Avancerad sökning med operatorer |
| Biblioteksbestånd |
| Alla utgåvor av ett verk |
| Sökförslag |
| Relaterade verk |
3. K-samsök (7 verktyg)
Kulturarv från 83 institutioner.
Verktyg | Beskrivning |
| CQL-sökning |
| Geografisk sökning |
| Sök efter objekttyp |
| Sök efter tidsperiod |
| Hämta specifikt objekt |
| Objektrelationer |
| Statistik och facetter |
4. OAI-PMH (5 verktyg)
Bulkexport av metadata.
Verktyg | Beskrivning |
| Lista poster |
| Hämta enskild post |
| Tillgängliga sets |
| Metadataformat |
| Paginering |
5. data.kb.se (5 verktyg)
Digitaliserat material.
Verktyg | Beskrivning |
| Lista samlingar |
| Hämta objekt |
| Sök digitaliserat |
| IIIF-manifest |
| Metadata i olika format |
6. Swepub (6 verktyg)
Svensk forskningspublicering.
Verktyg | Beskrivning |
| Sök publikationer |
| Sök efter forskare |
| Sök efter lärosäte |
| Sök efter ämne |
| Hämta publikation |
| Exportera till RIS/BibTeX |
7. id.kb.se (4 verktyg)
Auktoriteter och vokabulär.
Verktyg | Beskrivning |
| Hämta entitet |
| Sök auktoriteter |
| Hämta vokabulärterm |
| Lista vokabulär |
8. SPARQL (4 verktyg)
Länkad data-frågor.
Verktyg | Beskrivning |
| Kör SPARQL SELECT |
| Beskriv resurs |
| Räkna resultat |
| Frågemallar |
9. Export (5 verktyg)
Bibliografi och referenshantering.
Verktyg | Beskrivning |
| Författarbibliografi |
| Ämnesbibliografi |
| Exportera sökresultat |
| Skapa publikationslista |
| Information om format |
10. Hjälp (5 verktyg)
Dokumentation och metadata.
Verktyg | Beskrivning |
| Översikt alla API:er |
| Kontrollera status |
| Söktips och syntax |
| Datadefinitioner |
| Exempelfrågor |
📖 Användningsexempel
Hitta böcker av en författare
Sök kulturarvsobjekt
Exportera bibliografi till Zotero
SPARQL-analys
🌐 Remote URL (efter Render-deployment)
Använd i ChatGPT eller andra MCP-klienter:
Endpoints
Endpoint | Beskrivning |
| Health check |
| Server-information |
| SSE-transport (MCP) |
| Meddelanden (POST) |
🔒 Säkerhet
Ingen autentisering krävs - KB:s API:er är öppna
Ingen API-nyckel - Inga hemligheter att hantera
Rate limiting - Respektera KB:s servrar
📁 Projektstruktur
🧪 Testa
Förväntat resultat:
📚 Dokumentation
📄 Licens
MIT License - Använd fritt för alla ändamål.
👤 Författare
Utvecklad för åtkomst till Sveriges nationella biblioteksdata via Model Context Protocol.