mcp-open-Bibliothek

MCP Offene Bibliothek

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.

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 get_book_by_title :

{
  "title": "The Hobbit"
}

Beispielausgabe von get_book_by_title :

[
  {
    "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 get_authors_by_name :

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

Beispielausgabe von get_authors_by_name :

[
  {
    "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"
}

Beispielausgabe von get_author_info :

{
  "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 get_author_photo :

{
  "olid": "OL26320A"
}

Beispielausgabe von get_author_photo :

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

Beispiel für die Eingabe get_book_cover :

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

Beispielausgabe von get_book_cover :

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 get_book_by_id Eingabe:

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

Beispielausgabe von get_book_by_id :

{
  "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

Ausführen von Tests

npm test

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Danksagung

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

OpenAI MCP Server
arthurcolle
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables connection between OpenAI APIs and MCP clients for coding assistance with features like CLI interaction, web API integration, and tool-based architecture.
Last updated -
33
Python
searchAPI-mcp
RmMargt
-
security
A
license
-
quality
A Model Context Protocol (MCP) based search API server that provides standardized access to Google Maps, Google Flights, Google Hotels and other services. This server enables AI assistants to access various search services through a unified interface.
Last updated -
57
Python
MIT License
Lspace MCP Serverofficial
Lspace-io
A
security
F
license
A
quality
An open-source server implementing the Model Context Protocol (MCP) that enables capturing insights from AI sessions and transforming them into persistent, searchable knowledge accessible across tools.
Last updated -
7
5
TypeScript
Google Research MCP
mixelpixx
-
security
A
license
-
quality
Model Context Protocol (MCP) server that provides AI assistants with advanced web research capabilities, including Google search integration, intelligent content extraction, and multi-source synthesis.
Last updated -
52
3
TypeScript
MIT License

View all related MCP servers

mcp-open-library