🗃️ MCP Inventory — Servidor MCP para Gestión de Inventario

Proyecto desarrollado para el curso Computación Cognitiva para Big Data.
Implementa un servidor MCP en Python que expone operaciones CRUD y consultas analíticas sobre una base de datos SQLite de inventario.

📋 Requisitos

Herramienta	Versión mínima
Python	3.8+
SQLite3	Incluido en Python
fastmcp	última

🚀 Instalación

# 1. Clonar el repositorio
git clone https://github.com/<tu-usuario>/mcp_inventory.git
cd mcp_inventory

# 2. Crear y activar entorno virtual (recomendado)
python -m venv venv
source venv/bin/activate        # Linux / macOS
venv\Scripts\activate           # Windows

# 3. Instalar dependencias
pip install -r requirements.txt

▶️ Ejecución

python server.py

El servidor MCP quedará disponible para que un cliente (p. ej. Claude Desktop) lo consuma a través del protocolo MCP.

🛠️ Herramientas disponibles

CRUD

Herramienta	Descripción
`crear_producto`	Agrega un nuevo producto al inventario
`consultar_producto`	Busca un producto por su `id`
`actualizar_producto`	Modifica la cantidad de un producto
`eliminar_producto`	Elimina un producto por su `id`
`listar_productos`	Lista todos los productos

Analíticas

Herramienta	Descripción
`calcular_valor_total_inventario`	Suma `cantidad × precio` de todos los productos
`productos_agotados`	Lista productos con cantidad = 0
`producto_mas_costoso`	Producto con el precio unitario más alto
`estadisticas_inventario`	Total, promedios y valor total del inventario

📁 Estructura del proyecto

mcp_inventory/
├── server.py          # Servidor MCP con todas las herramientas
├── database.py        # Inicialización de la base de datos SQLite
├── requirements.txt   # Dependencias del proyecto
├── README.md          # Este archivo
└── inventory.db       # Base de datos (generada automáticamente)

🧪 Pruebas sugeridas

Desde un cliente MCP conectado al servidor, ejecutar:

Crear cinco productos de distintas categorías.
Consultar un producto por id.
Actualizar la cantidad de un producto.
Eliminar un producto.
Listar todos los productos.
Calcular el valor total del inventario.
Consultar productos agotados.
Identificar el producto más costoso.
Ver estadísticas generales del inventario.

📄 Licencia

MIT — libre uso académico.

MCP Inventory