MCP Offene Bibliothek

Schmiedeabzeichen

Ein Model Context Protocol (MCP)-Server für die Open Library API, der es KI-Assistenten ermöglicht, nach Buch- und Autoreninformationen zu suchen.

Überblick

Dieses Projekt implementiert einen MCP-Server, der KI-Assistenten Tools für die Interaktion mit der Open Library bereitstellt. Er ermöglicht die Suche nach Buchinformationen nach Titel, die Suche nach Autoren nach Namen, das Abrufen detaillierter Autoreninformationen über den Open Library-Schlüssel und das Abrufen von URLs für Autorenfotos über die Open Library-ID (OLID). Der Server gibt strukturierte Daten mit Buch- und Autoreninformationen zurück.

Related MCP server: searchAPI-mcp

Merkmale

Buchsuche nach Titel : Suchen Sie nach Büchern anhand ihres Titels ( get_book_by_title ).
Autorensuche nach Namen : Suchen Sie nach Autoren anhand ihres Namens ( get_authors_by_name ).
Autorendetails abrufen : Rufen Sie mithilfe des Open Library-Schlüssels ( get_author_info ) ausführliche Informationen zu einem bestimmten Autor ab.
Autorenfoto abrufen : Rufen Sie die URL für das Foto eines Autors mithilfe seiner Open Library ID (OLID) ab ( get_author_photo ).
Buchcover abrufen : Rufen Sie die URL für das Coverbild eines Buches mithilfe verschiedener Kennungen (ISBN, OCLC, LCCN, OLID, ID) ab ( get_book_cover ).
Buch nach ID abrufen : Rufen Sie detaillierte Buchinformationen mithilfe verschiedener Kennungen (ISBN, LCCN, OCLC, OLID) ab ( get_book_by_id ).

Installation

Installation über Smithery

So installieren Sie MCP Open Library für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @8enSmith/mcp-open-library --client claude

Manuelle Installation

# Clone the repository git clone https://github.com/your-username/mcp-open-library.git cd mcp-open-library # Install dependencies npm install # Build the project npm run build

Verwendung

Ausführen des Servers

Sie können den MCP Inspector verwenden, um den Server zu testen:

npm run inspector

Greifen Sie auf den MCP Inspector zu und testen Sie das Tool dann z. B.

Alternativtext

Verwendung mit einem MCP-Client

Dieser Server implementiert das Model Context Protocol und kann daher von jedem MCP-kompatiblen KI-Assistenten oder -Client, z. B. Claude Desktop , verwendet werden. Der Server stellt die folgenden Tools bereit:

get_book_by_title : Suche nach Buchinformationen nach Titel
get_authors_by_name : Suche nach Autoreninformationen nach Namen
get_author_info : Erhalten Sie detaillierte Informationen zu einem bestimmten Autor mithilfe seines Open Library Author Key
get_author_photo : Rufen Sie die URL für das Foto eines Autors mithilfe seiner Open Library Author ID (OLID) ab.
get_book_cover : Ruft die URL für das Coverbild eines Buches mithilfe einer bestimmten Kennung (ISBN, OCLC, LCCN, OLID oder ID) ab.
get_book_by_id : Erhalten Sie detaillierte Buchinformationen mithilfe einer bestimmten Kennung (ISBN, LCCN, OCLC oder OLID).

Beispiel für die Eingabe

{ "title": "The Hobbit" }

Beispielausgabe von

[ { "title": "The Hobbit", "authors": [ "J. R. R. Tolkien" ], "first_publish_year": 1937, "open_library_work_key": "/works/OL45883W", "edition_count": 120, "cover_url": "https://covers.openlibrary.org/b/id/10581294-M.jpg" } ]

Beispiel für die Eingabe

{ "name": "J.R.R. Tolkien" }

Beispielausgabe von

[ { "key": "OL26320A", "name": "J. R. R. Tolkien", "alternate_names": [ "John Ronald Reuel Tolkien" ], "birth_date": "3 January 1892", "top_work": "The Hobbit", "work_count": 648 } ]

Beispiel für

{ "author_key": "OL26320A" }

Beispielausgabe von

{ "name": "J. R. R. Tolkien", "personal_name": "John Ronald Reuel Tolkien", "birth_date": "3 January 1892", "death_date": "2 September 1973", "bio": "John Ronald Reuel Tolkien (1892-1973) was a major scholar of the English language, specializing in Old and Middle English. He served as the Rawlinson and Bosworth Professor of Anglo-Saxon and later the Merton Professor of English Language and Literature at Oxford University.", "alternate_names": ["John Ronald Reuel Tolkien"], "photos": [6791763], "key": "/authors/OL26320A", "remote_ids": { "viaf": "95218067", "wikidata": "Q892" }, "revision": 43, "last_modified": { "type": "/type/datetime", "value": "2023-02-12T05:50:22.881" } }

Beispiel für die Eingabe

{ "olid": "OL26320A" }

Beispielausgabe von

https://covers.openlibrary.org/a/olid/OL26320A-L.jpg

Beispiel für die Eingabe

{ "key": "ISBN", "value": "9780547928227", "size": "L" }

Beispielausgabe von

https://covers.openlibrary.org/b/isbn/9780547928227-L.jpg

Das Tool get_book_cover akzeptiert die folgenden Parameter:

key : Der Typ der Kennung (einer von: ISBN , OCLC , LCCN , OLID oder ID )
value : Der Wert des Bezeichners
size : Optionale Abdeckungsgröße ( S für klein, M für mittel, L für groß, standardmäßig L )

Beispiel für

{ "idType": "isbn", "idValue": "9780547928227" }

Beispielausgabe von

{ "title": "The Hobbit", "authors": [ "J. R. R. Tolkien" ], "publishers": [ "Houghton Mifflin Harcourt" ], "publish_date": "October 21, 2012", "number_of_pages": 300, "isbn_13": [ "9780547928227" ], "isbn_10": [ "054792822X" ], "oclc": [ "794607877" ], "olid": [ "OL25380781M" ], "open_library_edition_key": "/books/OL25380781M", "open_library_work_key": "/works/OL45883W", "cover_url": "https://covers.openlibrary.org/b/id/8231496-M.jpg", "info_url": "https://openlibrary.org/books/OL25380781M/The_Hobbit", "preview_url": "https://archive.org/details/hobbit00tolkien" }

Das Tool get_book_by_id akzeptiert die folgenden Parameter:

idType : Der Typ der Kennung (einer von: isbn , lccn , oclc , olid )
idValue : Der Wert der Kennung

Ein Beispiel für die Verwendung dieses Tools in Claude Desktop finden Sie hier:

Docker

Sie können diesen MCP-Server mit Docker testen. Führen Sie dazu zunächst Folgendes aus:

docker build -t mcp-open-library . docker run -p 8080:8080 mcp-open-library

Sie können dann den Server testen, der in Docker über den Inspector ausgeführt wird, z. B.

pnpm run inspector http://localhost:8080

Entwicklung

Projektstruktur

src/index.ts – Hauptserverimplementierung
src/types.ts – TypeScript-Typdefinitionen
src/index.test.ts – Testsuite

Verfügbare Skripte

npm run build – Erstellen Sie den TypeScript-Code
npm run watch - Auf Änderungen achten und neu erstellen
npm test - Führen Sie die Testsuite aus
npm run format – Code mit Prettier formatieren
npm run inspector - Führen Sie den MCP Inspector auf dem Server aus

mcp-open-library

MCP Offene Bibliothek

Überblick

Merkmale

Installation

Installation über Smithery

Manuelle Installation

Verwendung

Ausführen des Servers

Verwendung mit einem MCP-Client

Docker

Entwicklung

Projektstruktur

Verfügbare Skripte

Ausführen von Tests

Beitragen

Danksagung

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API