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

brew install uv

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

2. Configurar el proyecto

# Clonar o descargar el proyecto
cd basic-mcp

# Inicializar el proyecto uv (si no está inicializado)
uv init

# Crear entorno virtual
uv venv

# Activar entorno virtual
source .venv/bin/activate

# Instalar dependencias MCP
uv pip install "mcp[cli]"

3. Ejecutar el servidor

# Ejecutar en modo desarrollo
mcp dev server.py

📋 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

basic-mcp/
├── server.py          # Servidor MCP principal
├── main.py           # Script de entrada básico
├── pyproject.toml    # Configuración del proyecto
├── uv.lock          # Archivo de bloqueo de dependencias
├── README.md        # Documentación del proyecto
├── .gitignore       # Archivos ignorados por Git
├── .python-version  # Versión de Python
└── .venv/          # Entorno virtual (ignorado por Git)

🔄 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