biblioteca abierta mcp

Biblioteca Abierta MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para la API de Open Library que permite a los asistentes de IA buscar información de libros y autores.

Descripción general

Este proyecto implementa un servidor MCP que proporciona herramientas para que los asistentes de IA interactúen con Open Library . Permite buscar información de libros por título, buscar autores por nombre, recuperar información detallada de los autores mediante su clave de Open Library y obtener las URL de las fotos de los autores mediante su ID de Open Library (OLID). El servidor devuelve datos estructurados de la información de libros y autores.

Características

Búsqueda de libros por título : busque libros utilizando su título ( get_book_by_title ).
Búsqueda de autor por nombre : busca autores utilizando su nombre ( get_authors_by_name ).
Obtener detalles del autor : recupere información detallada de un autor específico utilizando su clave de Open Library ( get_author_info ).
Obtener foto del autor : obtenga la URL de la foto de un autor usando su ID de Open Library (OLID) ( get_author_photo ).
Obtener portada de libro : obtenga la URL de la imagen de portada de un libro utilizando varios identificadores (ISBN, OCLC, LCCN, OLID, ID) ( get_book_cover ).

Instalación

Instalación mediante herrería

Para instalar MCP Open Library para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

# 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

Uso

Ejecución del servidor

Puede utilizar el Inspector MCP para probar el servidor:

npm run inspector

Acceda al Inspector MCP y luego pruebe la herramienta, por ejemplo

texto alternativo

Uso con un cliente MCP

Este servidor implementa el Protocolo de Contexto de Modelo, lo que significa que puede ser utilizado por cualquier asistente o cliente de IA compatible con MCP, como Claude Desktop . El servidor expone las siguientes herramientas:

get_book_by_title : Busca información del libro por título
get_authors_by_name : Busca información del autor por nombre
get_author_info : Obtenga información detallada de un autor específico utilizando su clave de autor de Open Library
get_author_photo : Obtener la URL de la foto de un autor usando su ID de autor de Open Library (OLID)
get_book_cover : obtiene la URL de la imagen de portada de un libro utilizando un identificador específico (ISBN, OCLC, LCCN, OLID o ID)

Ejemplo de entrada get_book_by_title :

{
  "title": "The Hobbit"
}

Ejemplo de salida 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"
  }
]

Ejemplo de entrada get_authors_by_name :

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

Ejemplo de salida 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
  }
]

Ejemplo de entrada get_author_info :

{
  "author_key": "OL26320A"
}

Ejemplo de salida 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"
  }
}

Ejemplo de entrada get_author_photo :

{
  "olid": "OL26320A"
}

Ejemplo de salida get_author_photo :

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

Ejemplo de entrada get_book_cover :

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

Ejemplo de salida get_book_cover :

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

La herramienta get_book_cover acepta los siguientes parámetros:

key : el tipo de identificador (uno de los siguientes: ISBN , OCLC , LCCN , OLID o ID )
value : El valor del identificador
size : Tamaño de cubierta opcional ( S para pequeño, M para mediano, L para grande, predeterminado L )

Un ejemplo del uso de esta herramienta en Claude Desktop se puede ver aquí:

Estibador

Puedes probar este servidor MCP con Docker. Para ello, primero ejecuta:

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

Luego puede probar el servidor ejecutándose dentro de Docker a través del inspector, por ejemplo:

pnpm run inspector http://localhost:8080

Desarrollo

Estructura del proyecto

src/index.ts - Implementación del servidor principal
src/types.ts - Definiciones de tipos de TypeScript
src/index.test.ts - Conjunto de pruebas

Scripts disponibles

npm run build - Construye el código TypeScript
npm run watch : vigila los cambios y reconstruye
npm test - Ejecutar el conjunto de pruebas
npm run format - Formatear código con Prettier
npm run inspector : ejecuta el inspector MCP contra el servidor

Ejecución de pruebas

npm test

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Expresiones de gratitud

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.

Un servidor de Protocolo de Contexto de Modelo (MCP) para la API de Open Library que permite a los asistentes de IA buscar información de libros.

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