Skip to main content
Glama
Sign In
deenesjakoruzh

mcp-open-library

by 8enSmith
GitHub
TypeScript
MIT License
5
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Referenced in the repository URL for cloning the project.

  • Used for package management and running scripts.

  • Used for code formatting in the development workflow.

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.

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Überblick
    1. Merkmale
      1. Installation
        1. Installation über Smithery
        2. Manuelle Installation
      2. Verwendung
        1. Ausführen des Servers
        2. Verwendung mit einem MCP-Client
        3. Docker
      3. Entwicklung
        1. Projektstruktur
        2. Verfügbare Skripte
        3. Ausführen von Tests
      4. Beitragen
        1. Danksagung

          Related MCP Servers

          • Exa MCP Server

            exa-labs
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
            Last updated -
            1
            1,997
            1,526
            TypeScript
            MIT License
            • Apple

          • Open-Ledger-MCP-Serverofficial

            openledger
            -
            security
            A
            license
            -
            quality
            A Model Context Protocol (MCP) server implementation for the OpenLedger API. This server provides structured context to AI models according to the MCP specification.
            Last updated -
            8
            TypeScript
            Apache 2.0

          • MCP Kibela

            kj455
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.
            Last updated -
            6
            107
            9
            TypeScript
            MIT License

          • MCP Outline Server

            Vortiago
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
            Last updated -
            25
            1
            Python
            MIT License

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          ID: qhkblspta2