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+

Version 2.1.0

Funktion	Antal
Verktyg (Tools)	57
Resurser (Resources)	7
Promptmallar (Prompts)	8

🚀 Installation

Lokal installation (Claude Desktop, Claude Code)

# Klona eller ladda ner
cd kb-mcp-server

# Skapa virtuell miljö (rekommenderat)
python -m venv venv
source venv/bin/activate  # Linux/Mac
# eller: venv\Scripts\activate  # Windows

# Installera dependencies
pip install -r requirements.txt

# Testa
python test_kb_mcp.py

Claude Desktop-konfiguration

Lägg till i ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) eller motsvarande:

{
  "mcpServers": {
    "kb-api": {
      "command": "python",
      "args": ["kb_mcp_server.py"],
      "cwd": "/full/path/to/kb-mcp-server"
    }
  }
}

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.txt
- Start Command: python kb_mcp_server.py --http --port $PORT
Hämta URL: https://your-service.onrender.com

Alternativt, använd Blueprint:

render blueprint sync

Docker

docker build -t kb-mcp-server .
docker run -p 8000:8000 kb-mcp-server

🔧 Verktyg per Endpoint

1. Libris Xsearch (5 verktyg)

Enkel bibliotekssökning med 20M+ poster.

Verktyg	Beskrivning
`libris_search`	Fritextsökning
`libris_search_author`	Sök efter författare
`libris_search_title`	Sök efter titel
`libris_search_subject`	Sök efter ämne
`libris_search_isbn`	Sök efter ISBN

2. Libris XL REST (6 verktyg)

Avancerad åtkomst till bibliografisk data.

Verktyg	Beskrivning
`libris_get_record`	Hämta specifik post
`libris_find`	Avancerad sökning med operatorer
`libris_get_holdings`	Biblioteksbestånd
`libris_get_work`	Alla utgåvor av ett verk
`libris_autocomplete`	Sökförslag
`libris_related`	Relaterade verk

3. K-samsök (7 verktyg)

Kulturarv från 83 institutioner.

Verktyg	Beskrivning
`ksamsok_search`	CQL-sökning
`ksamsok_search_location`	Geografisk sökning
`ksamsok_search_type`	Sök efter objekttyp
`ksamsok_search_time`	Sök efter tidsperiod
`ksamsok_get_object`	Hämta specifikt objekt
`ksamsok_get_relations`	Objektrelationer
`ksamsok_statistics`	Statistik och facetter

4. OAI-PMH (5 verktyg)

Bulkexport av metadata.

Verktyg	Beskrivning
`oaipmh_list_records`	Lista poster
`oaipmh_get_record`	Hämta enskild post
`oaipmh_list_sets`	Tillgängliga sets
`oaipmh_list_formats`	Metadataformat
`oaipmh_resume`	Paginering

5. data.kb.se (5 verktyg)

Digitaliserat material.

Verktyg	Beskrivning
`kb_data_list_collections`	Lista samlingar
`kb_data_get_item`	Hämta objekt
`kb_data_search`	Sök digitaliserat
`kb_data_get_manifest`	IIIF-manifest
`kb_data_get_metadata`	Metadata i olika format

6. Swepub (6 verktyg)

Svensk forskningspublicering.

Verktyg	Beskrivning
`swepub_search`	Sök publikationer
`swepub_search_author`	Sök efter forskare
`swepub_search_affiliation`	Sök efter lärosäte
`swepub_search_subject`	Sök efter ämne
`swepub_get_publication`	Hämta publikation
`swepub_export`	Exportera till RIS/BibTeX

7. id.kb.se (4 verktyg)

Auktoriteter och vokabulär.

Verktyg	Beskrivning
`idkb_get_entity`	Hämta entitet
`idkb_search`	Sök auktoriteter
`idkb_get_vocab_term`	Hämta vokabulärterm
`idkb_list_vocab`	Lista vokabulär

8. SPARQL (4 verktyg)

Länkad data-frågor.

Verktyg	Beskrivning
`sparql_query`	Kör SPARQL SELECT
`sparql_describe`	Beskriv resurs
`sparql_count`	Räkna resultat
`sparql_templates`	Frågemallar

9. Export (5 verktyg)

Bibliografi och referenshantering.

Verktyg	Beskrivning
`export_author_bibliography`	Författarbibliografi
`export_subject_bibliography`	Ämnesbibliografi
`export_search_results`	Exportera sökresultat
`export_publication_list`	Skapa publikationslista
`export_formats_info`	Information om format

10. Hjälp (5 verktyg)

Dokumentation och metadata.

Verktyg	Beskrivning
`kb_api_info`	Översikt alla API:er
`kb_api_status`	Kontrollera status
`kb_search_tips`	Söktips och syntax
`kb_data_dictionary`	Datadefinitioner
`kb_example_queries`	Exempelfrågor

11. Nya förbättrade verktyg (5 verktyg)

Kraftfulla verktyg för avancerade användningsfall.

Verktyg	Beskrivning
`combined_search`	Sök i flera databaser samtidigt
`quick_stats`	Snabbstatistik från alla API:er
`find_related_works`	Hitta relaterade verk
`historical_periods_search`	Sök efter historisk period
`swedish_counties_info`	Lista svenska län

📚 MCP Resources

Read-only resurser för dokumentation och referens:

Resurs URI	Beskrivning
`kb://api/overview`	Översikt över alla API:er
`kb://search/syntax`	Komplett söksyntax-guide
`kb://examples/libris`	Libris-exempel
`kb://examples/ksamsok`	K-samsök-exempel
`kb://examples/sparql`	SPARQL-exempel
`kb://examples/research`	Swepub-exempel
`kb://data/objecttypes`	K-samsök objekttyper

💬 MCP Prompts

Fördefinierade promptmallar för vanliga uppgifter:

Prompt	Beskrivning	Parametrar
`prompt_find_books_by_author`	Hitta böcker av författare	`author_name`
`prompt_research_topic`	Utforska ett ämne	`topic`
`prompt_genealogy_search`	Släktforskning	`parish`, `county`
`prompt_cultural_heritage_location`	Kulturarv per län	`county`
`prompt_export_bibliography`	Skapa bibliografi	`topic`, `format`
`prompt_sparql_analysis`	SPARQL-analys	`analysis_type`
`prompt_time_period_search`	Tidsperiod-sökning	`from_year`, `to_year`
`prompt_compare_institutions`	Jämför lärosäten	`institution1`, `institution2`

📖 Användningsexempel

Hitta böcker av en författare

libris_search_author(author_name="Lagerlöf, Selma")

Sök kulturarvsobjekt

ksamsok_search(query='itemType=Photograph AND countyName="Uppsala län"')

Exportera bibliografi till Zotero

export_author_bibliography(author_name="Strindberg, August", format="ris")

SPARQL-analys

sparql_query(query="SELECT ?author (COUNT(?work) AS ?count) WHERE { ?work dc:creator ?author } GROUP BY ?author ORDER BY DESC(?count) LIMIT 10")

🌐 Remote URL (efter Render-deployment)

Använd i ChatGPT eller andra MCP-klienter:

https://your-service.onrender.com/sse

Endpoints

Endpoint	Beskrivning
`/health`	Health check
`/info`	Server-information
`/sse`	SSE-transport (MCP)
`/messages/`	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

kb-mcp-server/
├── kb_mcp_server.py      # Huvudserver med alla 52 verktyg
├── src/
│   ├── __init__.py
│   └── api_client.py     # HTTP-klient och hjälpfunktioner
├── requirements.txt      # Python-dependencies
├── Procfile             # Render startkommando
├── render.yaml          # Render Blueprint
├── Dockerfile           # Docker-image
├── test_kb_mcp.py       # Testsvit
├── claude_desktop_config.example.json
├── TOOL_DESIGN.md       # Verktygsdesign
└── README.md            # Denna fil

🧪 Testa

python test_kb_mcp.py

Förväntat resultat:

KB MCP Server - Testsvit
============================================================
🔍 Test: Libris Xsearch...
   ✅ OK - 7432 träffar för 'Astrid Lindgren'
🔍 Test: Libris XL...
   ✅ OK - 3 poster för 'Strindberg'
🔍 Test: K-samsök...
   ✅ OK - 12023 runstenar hittade
🔍 Test: OAI-PMH...
   ✅ OK - 5 sets tillgängliga
🔍 Test: id.kb.se...
   ✅ OK - 5 auktoriteter för 'Strindberg'
🔍 Test: Swepub...
   ✅ OK - 15234 forskningspublikationer
============================================================
Resultat: 6/6 tester godkända

📚 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.