mcp-open-library
MCP Open Library
Ein Model Context Protocol (MCP)-Server für die Open Library API, der es KI-Assistenten ermöglicht, nach Buch- und Autoreninformationen zu suchen.
Übersicht
Dieses Projekt implementiert einen MCP-Server, der Tools für KI-Assistenten bereitstellt, um mit der Open Library zu interagieren. Er ermöglicht die Suche nach Buchinformationen anhand des Titels, die Suche nach Autoren anhand des Namens, das Abrufen detaillierter Autoreninformationen mithilfe ihres Open Library-Schlüssels sowie das Abrufen von URLs für Autorenfotos mithilfe ihrer Open Library ID (OLID). Der Server liefert strukturierte Daten für Buch- und Autoreninformationen zurück.
Related MCP server: bookstore-mcp-server
Funktionen
Buchsuche nach Titel: Suche nach Büchern anhand ihres Titels (
get_book_by_title).Autorensuche nach Name: Suche nach Autoren anhand ihres Namens (
get_authors_by_name).Autorendetails abrufen: Abrufen detaillierter Informationen zu einem bestimmten Autor mithilfe seines Open Library-Schlüssels (
get_author_info).Autorenfoto abrufen: Abrufen der URL für das Foto eines Autors mithilfe seiner Open Library ID (OLID) (
get_author_photo).Buchcover abrufen: Abrufen der URL für das Coverbild eines Buches mithilfe verschiedener Identifikatoren (ISBN, OCLC, LCCN, OLID, ID) (
get_book_cover).Buch nach ID abrufen: Abrufen detaillierter Buchinformationen mithilfe verschiedener Identifikatoren (ISBN, LCCN, OCLC, OLID) (
get_book_by_id).
Installation
Installation über Smithery
Um MCP Open Library für Claude Desktop automatisch über Smithery zu installieren:
npx -y @smithery/cli install @8enSmith/mcp-open-library --client claudeManuelle Installation
# Clone the repository
git clone https://github.com/8enSmith/mcp-open-library.git
cd mcp-open-library
# Install dependencies
npm install
# Build the project
npm run buildVerwendung
Ausführen des Servers
Stellen Sie sicher, dass Sie Node v22.21.1 verwenden (es funktioniert wahrscheinlich auch mit einer neueren Node-Version, aber diese verwende ich für diesen Test). Wenn Sie
nvminstalliert haben, führen Sienvm useaus.Führen Sie im Stammverzeichnis von
mcp-open-libraryden Befehlnpm run buildaus.Führen Sie anschließend
npm run inspectoraus. Klicken Sie nach dem Build auf die URL mit dem AbfrageparameterMCP_PROXY_AUTH_TOKEN, um den Inspector zu öffnen.Wählen Sie im Inspector den Transport 'STDIO'.
Stellen Sie sicher, dass der Befehl auf 'build/index.js' gesetzt ist.
Klicken Sie im Inspector auf die Schaltfläche 'Connect' – Sie werden nun mit dem Server verbunden.
Klicken Sie in der oberen rechten Menüleiste auf 'Tools'.
Versuchen Sie, ein Tool auszuführen, z. B. klicken Sie auf get_book_by_title.
Suchen Sie nach einem Buch, z. B. geben Sie im Titelfeld 'The Hobbit' ein und klicken Sie dann auf 'Run Tool'. Der Server gibt daraufhin die Buchdetails zurück.
Verwendung mit einem MCP-Client
Dieser Server implementiert das Model Context Protocol, was bedeutet, dass er von jedem MCP-kompatiblen KI-Assistenten oder Client verwendet werden kann, z. B. Claude Desktop. Der Server stellt die folgenden Tools bereit:
get_book_by_title: Suche nach Buchinformationen anhand des Titelsget_authors_by_name: Suche nach Autoreninformationen anhand des Namensget_author_info: Abrufen detaillierter Informationen zu einem bestimmten Autor mithilfe seines Open Library Author Keyget_author_photo: Abrufen der URL für das Foto eines Autors mithilfe seiner Open Library Author ID (OLID)get_book_cover: Abrufen der URL für das Coverbild eines Buches mithilfe eines bestimmten Identifikators (ISBN, OCLC, LCCN, OLID oder ID)get_book_by_id: Abrufen detaillierter Buchinformationen mithilfe eines bestimmten Identifikators (ISBN, LCCN, OCLC oder OLID)
Beispiel für get_book_by_title Eingabe:
{
"title": "The Hobbit"
}Beispiel für get_book_by_title Ausgabe:
[
{
"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 get_authors_by_name Eingabe:
{
"name": "J.R.R. Tolkien"
}Beispiel für get_authors_by_name Ausgabe:
[
{
"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 get_author_info Eingabe:
{
"author_key": "OL26320A"
}Beispiel für get_author_info Ausgabe:
{
"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 get_author_photo Eingabe:
{
"olid": "OL26320A"
}Beispiel für get_author_photo Ausgabe:
https://covers.openlibrary.org/a/olid/OL26320A-L.jpgBeispiel für get_book_cover Eingabe:
{
"key": "ISBN",
"value": "9780547928227",
"size": "L"
}Beispiel für get_book_cover Ausgabe:
https://covers.openlibrary.org/b/isbn/9780547928227-L.jpgDas Tool get_book_cover akzeptiert die folgenden Parameter:
key: Der Typ des Identifikators (einer der folgenden:ISBN,OCLC,LCCN,OLIDoderID)value: Der Wert des Identifikatorssize: Optionale Covergröße (Sfür klein,Mfür mittel,Lfür groß, Standard istL)
Beispiel für get_book_by_id Eingabe:
{
"idType": "isbn",
"idValue": "9780547928227"
}Beispiel für get_book_by_id Ausgabe:
{
"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 des Identifikators (einer der folgenden:isbn,lccn,oclc,olid)idValue: Der Wert des Identifikators
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 zuerst Folgendes aus:
docker build -t mcp-open-library .
docker run -p 8080:8080 mcp-open-librarySie können dann den in Docker laufenden Server über den Inspector testen, z. B.:
npm run inspector http://localhost:8080Entwicklung
Projektstruktur
src/index.ts- Hauptserver-Implementierungsrc/types.ts- TypeScript-Typdefinitionensrc/index.test.ts- Test-Suite
Verfügbare Skripte
npm run build- TypeScript-Code bauennpm run watch- Auf Änderungen achten und neu bauennpm test- Test-Suite ausführennpm run format- Code mit Prettier formatierennpm run inspector- MCP Inspector gegen den Server ausführen
Tests ausführen
npm testMitwirken
Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.
Danksagungen
Available Tools
7 toolsget_author_infoGet author detailsARead-only
Get detailed information for a specific author using their Open Library Author Key (e.g. OL23919A).
Inputs: author_key (required).
get_author_photoGet author photo URLARead-only
Get the URL for an author's photo using their Open Library Author ID (OLID e.g. OL23919A). Reports when no photo exists rather than returning a URL to a blank placeholder.
Inputs: olid (required).
get_authors_by_nameFind authors by nameARead-only
Search for author information on Open Library. Returns at most limit authors (default 10) together with num_found, the total number of matches; page through them with offset. Each result's key can be passed to get_author_info for that author's full record.
Inputs: name (required), limit, offset.
get_book_by_idGet book by identifierARead-only
Get detailed information about a book using its identifier (ISBN, LCCN, OCLC, OLID).
Inputs: idType (required), idValue (required).
get_book_by_titleFind books by titleARead-only
Search for a book by its title on Open Library. Returns at most limit results (default 10) together with num_found, the total number of matches; page through them with offset. Each result carries best_edition — one edition of the work, with its isbn_13/isbn_10 where Open Library has them, and its edition_key, which can be passed to get_book_by_id as { idType: "olid" } for that edition's full record.
Inputs: title (required), limit, offset.
get_book_coverGet book cover URLARead-only
Get the URL for a book's cover image using a key (ISBN, OCLC, LCCN, OLID, ID) and value. Reports when no cover exists rather than returning a URL to a blank placeholder.
Inputs: key (required), value (required), size.
search_booksSearch booksARead-only
Search Open Library across titles, authors, subjects, places, people, publishers and ISBNs. Provide at least one search criterion: q, title, author, subject, place, person, publisher, isbn; combining several narrows the search. Returns at most limit results (default 10) together with num_found, the total number of matches; page through them with offset. Each result carries best_edition — one edition of the work, with its isbn_13/isbn_10 where Open Library has them, and its edition_key, which can be passed to get_book_by_id as { idType: "olid" } for that edition's full record.
Inputs: q, isbn, sort, limit, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools are clearly separated by resource and action, but get_book_by_title overlaps heavily with search_books since it returns the same result structure and is essentially a subset of the general search. The book/author detail and cover/photo tools are unambiguous.
Naming mostly follows a consistent get_<resource>_by_<qualifier> pattern, e.g. get_book_by_id, get_book_by_title, get_author_photo. search_books breaks the get_ convention but remains readable and predictable alongside the others.
Seven tools is well-scoped for a read-only Open Library server. Each tool addresses a distinct lookup need without the collection feeling bloated or thin.
The surface covers general book search, book lookup by ID/title, author search, author details, author photos, and book covers. Minor gaps exist, such as no direct endpoint for works or edition lists beyond indirection through edition_key, but core reading workflows are covered.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- FlicenseBqualityDmaintenanceA Model Context Protocol server implementation that can be run directly or through Docker, enabling AI assistants to interact with external systems through the MCP standard.2-
- FlicenseNot gradedqualityDmaintenanceAn MCP server that exposes tools for querying a bookstore inventory, allowing AI agents to search and retrieve book information via the Model Context Protocol.1-
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables searching books and authors, fetching editions, browsing subjects, and resolving cover images from Open Library.267 npm4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for Google Books API, enabling volume details, ISBN lookup, and bookshelf access via natural language queries.88 npm1MIT