Biblioteca Digital MCP

📚 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