📚 Biblioteca Digital MCP

Un servidor Model Context Protocol (MCP) que implementa una biblioteca digital interactiva con funcionalidades para gestionar libros, buscar títulos y generar reseñas literarias.

🎯 Características

• 🔍 Búsqueda de libros: Busca libros por título o autor

• 📖 Agregar libros: Agrega nuevos libros a la biblioteca

• 📄 Información detallada: Obtén información completa de cualquier libro

• ✍️ Generación de reseñas: Genera prompts para crear reseñas literarias profesionales

• 💾 Base de datos en memoria: Almacena libros con información completa

🛠 Prerrequisitos

• Python 3.12+

• uv (Ultra-fast Python package installer)

• macOS, Linux o Windows

🚀 Instalación y Configuración

1. Instalar uv

Si estás en macOS:

Para otros sistemas operativos, consulta la documentación oficial de uv.

2. Configurar el proyecto

3. Ejecutar el servidor

📋 Funcionalidades Disponibles

🔧 Tools (Herramientas)

1. buscar_libro(termino: str)

   • Busca libros por título o autor

   • Ejemplo: buscar_libro("García Márquez")

2. agregar_libro(titulo: str, autor: str, año: int, genero: str)

   • Agrega un nuevo libro a la biblioteca

   • Ejemplo: agregar_libro("1984", "George Orwell", 1949, "Distopía")

📚 Resources (Recursos)

• biblioteca://libro/{libro_id}

  • Proporciona información detallada en formato JSON de un libro específico

  • Ejemplo: biblioteca://libro/1

💭 Prompts

• generar_reseña(libro_id: str)

  • Genera un prompt profesional para crear reseñas literarias

  • Incluye análisis de estilo, temas, contexto histórico y valoración crítica

📊 Base de Datos Inicial

El servidor incluye dos libros precargados:

1. "Cien años de soledad" - Gabriel García Márquez (1967)

2. "Don Quijote de la Mancha" - Miguel de Cervantes (1605)

🏗 Estructura del Proyecto

🔄 Flujo de Trabajo

1. Iniciar el servidor: mcp dev server.py

2. Conectar un cliente MCP compatible

3. Utilizar las herramientas:

   • Buscar libros existentes

   • Agregar nuevos títulos

   • Consultar información detallada

   • Generar reseñas literarias

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Puedes:

• Agregar nuevas funcionalidades

• Mejorar la base de datos de libros

• Optimizar las búsquedas

• Expandir los prompts de reseñas

📝 Notas Técnicas

• Utiliza FastMCP para simplificar la implementación del servidor

• La base de datos es en memoria, los datos se pierden al reiniciar

• Compatible con el estándar Model Context Protocol

• Diseñado para ser usado con clientes MCP como Claude Desktop

Desarrollado con ❤️ usando Model Context Protocol y uv