KB MCP Server

MCP-server för åtkomst till Kungliga bibliotekets öppna API:er - Sveriges nationella biblioteksdata, kulturarv, forskning och länkad data.

📊 Översikt

Version 2.1.0

🚀 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)

1. Push till GitHub
2. 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
3. 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.

2. Libris XL REST (6 verktyg)

Avancerad åtkomst till bibliografisk data.

3. K-samsök (7 verktyg)

Kulturarv från 83 institutioner.

4. OAI-PMH (5 verktyg)

Bulkexport av metadata.

5. data.kb.se (5 verktyg)

Digitaliserat material.

6. Swepub (6 verktyg)

Svensk forskningspublicering.

7. id.kb.se (4 verktyg)

Auktoriteter och vokabulär.

8. SPARQL (4 verktyg)

Länkad data-frågor.

9. Export (5 verktyg)

Bibliografi och referenshantering.

10. Hjälp (5 verktyg)

Dokumentation och metadata.

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

Kraftfulla verktyg för avancerade användningsfall.

📚 MCP Resources

Read-only resurser för dokumentation och referens:

💬 MCP Prompts

Fördefinierade promptmallar för vanliga uppgifter:

📖 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

🔒 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

• KB:s API-dokumentation
• Libris
• K-samsök
• MCP Specification

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