cataloger mcp server

Ein Model Context Protocol (MCP) Server, der Zugriff auf die Library of Congress Subject Headings (LCSH) über eine einfache API-Schnittstelle bietet.

Übersicht

Dieser MCP-Server ermöglicht es KI-Assistenten wie Claude, die Library of Congress Subject Headings (LCSH) mithilfe der öffentlichen suggest2-API zu durchsuchen. Er bietet eine saubere Schnittstelle für die Abfrage von LCSH-Daten und die Verarbeitung der verschiedenen Antwortformate der API.

Related MCP server: MeSH MCP

Installation

Option 1: Installation von PyPI (Empfohlen)

Der einfachste Weg, den cataloger mcp server zu installieren, ist direkt über PyPI:

pip install cataloger-mcp-server

Option 2: Installation aus dem Quellcode

Wenn Sie die Installation aus dem Quellcode bevorzugen:

git clone https://github.com/kltng/cataloger-mcp-server.git
cd cataloger-mcp-server
pip install -e .

Einrichtung mit Claude Desktop

1. Installieren Sie Claude Desktop, falls Sie dies noch nicht getan haben, unter https://claude.ai/desktop

2. Installieren Sie den cataloger mcp server mit einer der oben genannten Installationsmethoden

3. Öffnen Sie Claude Desktop und navigieren Sie zu den Einstellungen:

   • Klicken Sie auf Ihr Profilbild in der unteren linken Ecke

   • Wählen Sie "Settings" aus dem Menü

4. Konfigurieren Sie den MCP-Server:

   • Klicken Sie im Einstellungsbereich auf "MCP Servers"

   • Klicken Sie auf "Add Server"

   • Geben Sie die folgenden Details ein:

     • Name: cataloger mcp search

     • Command: cataloger-mcp-server

   • Klicken Sie auf "Save"

5. Aktivieren Sie den Server:

   • Betätigen Sie den Schalter neben dem cataloger mcp search Server, um ihn zu aktivieren

   • Claude hat nun Zugriff auf die LCSH-Suchfunktionen

Einrichtung mit Cherry Studio

1. Installieren Sie Cherry Studio gemäß den Anweisungen in der Cherry-Dokumentation: https://docs.cherry-ai.com/docs/en-us/advanced-basic/mcp/install

2. Installieren Sie den cataloger mcp server mit einer der oben genannten Installationsmethoden.

3. Bereiten Sie die MCP JSON-Konfiguration für Cherry Studio vor. Verwenden Sie die Methode "Import JSON" mit einem Snippet wie diesem:

   {
     "mcpServers": {
       "cataloger-mcp": {
         "command": "uvx",
         "args": ["cataloger-mcp-server"]
       }
     }
   }

   • Sie können den Schlüssel "cataloger-mcp" in Cherry Studio in ein beliebiges Label Ihrer Wahl ändern.

4. Importieren in Cherry Studio:

   • Öffnen Sie Cherry Studio und gehen Sie zu Settings → MCP (oder MCP Servers).

   • Klicken Sie auf Add / Import from JSON (die Bezeichnung kann je nach Version leicht variieren).

   • Fügen Sie das obige JSON-Snippet ein und bestätigen Sie das Hinzufügen des Servers.

5. Überprüfen Sie den Server:

   • Stellen Sie sicher, dass der neue cataloger-mcp-server-Eintrag in der MCP-Liste erscheint und aktiviert ist.

   • Starten Sie einen neuen Chat und bestätigen Sie, dass Cherry Studio die cataloger MCP-Tools aufrufen kann.

Verwendung des cataloger mcp servers mit Claude

Sobald der Server in Claude Desktop eingerichtet und aktiviert ist, können Sie Claude bitten, die Library of Congress Subject Headings zu durchsuchen. Hier sind einige Beispiel-Prompts:

• "Kannst du die Library of Congress Subject Headings nach 'artificial intelligence' durchsuchen?"

• "Suche 'climate change' in LCSH und nenne mir die offiziellen Schlagwörter."

• "Welche LCSH-Begriffe sind mit 'quantum computing' verwandt?"

Claude wird den MCP-Server verwenden, um die LCSH- und LCNAF-Datenbanken abzufragen und die Ergebnisse zurückzugeben.

• "Finde den Namensdatensatz für 'Smith, John Adam'."

• "Führe eine Stichwortsuche in LCSH nach 'environmental policy' durch."

Funktionen

• MCP-Tool-Integration: Stellt die Tools search_lcsh (für Schlagwörter, standardmäßig linksbündige Suche), search_lcsh_keyword (für Schlagwörter, Stichwortsuche) und search_name_authority (für Personennamen) bereit, die von KI-Assistenten verwendet werden können.

• Ressourcen-Endpunkte: Bietet Ressourcen-Endpunkte unter lcsh://search/{query} und lcnaf://search/{query}.

• Robuste Fehlerbehandlung: Geht elegant mit API-Fehlern, Verbindungsproblemen und unerwarteten Antwortformaten um.

• Mehrere Antwortformate: Unterstützt sowohl Wörterbuch- (Treffer) als auch Listen-Antwortformate der LCSH-API.

Fehlerbehebung

Wenn Sie Probleme mit dem MCP-Server haben:

1. Serverstatus prüfen: Gehen Sie in Claude Desktop zu Settings > MCP Servers und prüfen Sie, ob der Server aktiviert ist und läuft.

2. Server neu starten: Schalten Sie den Server aus und wieder ein.

3. Konsolenausgabe prüfen: Wenn Sie den Server manuell ausführen, prüfen Sie die Konsolenausgabe auf Fehlermeldungen.

4. Netzwerkverbindung prüfen: Stellen Sie sicher, dass Ihr Computer über eine aktive Internetverbindung verfügt, um auf die LCSH-API zuzugreifen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE-Datei für Details.

Für Entwickler

Für eine detailliertere Dokumentation zur Serverimplementierung, API-Referenzen und Testinformationen lesen Sie bitte die Datei references.md.