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.

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.

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 y obtenga información detallada
Búsqueda de autor por nombre : busque autores utilizando su nombre y obtenga detalles relevantes
Formato de respuesta estructurada : devuelve información del libro y del autor en una estructura JSON consistente
Manejo de errores : validación adecuada y generación de informes de errores
Pruebas : Cobertura de pruebas completa con Vitest

Instalación

# 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

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)

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

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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.

Appeared in Searches

A server for retrieving papers on arXiv