Which integrations are available for this server?

Provides inventory management system with tools for managing items and categories, including operations for listing, searching, creating, updating, and deleting inventory records stored in [MongoDB](/mcp/servers/integrations/mongodb). Uses [Mongoose](/mcp/servers/integrations/mongoose) models for data schema definition and validation in the inventory management system, enabling structured database operations with MongoDB.

📦 MCP Inventario - Sistema Modular

Sistema de inventario implementado como servidor MCP (Model Context Protocol) con arquitectura modular y soporte para múltiples bases de datos.

🚀 Inicio Rápido

Instalación

npm install

Configurar MongoDB

Asegúrate de tener MongoDB corriendo en localhost:27017, o configura la variable de entorno:

export MONGODB_URI="mongodb://localhost:27017/inventario"

Ejecutar el Servidor MCP

node index.js

Probar con el Cliente de Pruebas

node test-client.js

Chat con Groq (Requiere API Key)

export GROQ_API_KEY="tu-api-key" node chat-groq.js

📁 Archivos Principales

✅ Archivos que DEBES USAR

Archivo	Propósito
`index.js`	Servidor principal modular - Punto de entrada del servidor MCP
`test-client.js`	Cliente de pruebas para probar las herramientas MCP
`chat-groq.js`	Chat interactivo usando Groq AI + herramientas MCP
`src/`	Directorio con toda la lógica modular del proyecto

⚠️ Archivo OBSOLETO (No usar)

Archivo

Estado

mcp-server.js

OBSOLETO

- Reemplazado por

index.js

+ estructura modular en

src/

Nota: mcp-server.js se mantiene solo como referencia. Toda la funcionalidad está ahora en la estructura modular.

🏗️ Estructura del Proyecto

experiments-mcp/ ├── index.js ✅ Servidor principal (USA ESTE) ├── chat-groq.js ✅ Chat con Groq AI ├── test-client.js ✅ Cliente de pruebas ├── mcp-server.js ⚠️ OBSOLETO (no usar) │ └── src/ ├── database/ # Gestión de base de datos │ ├── db.js # Clase Database (multi-conexión) │ ├── models/ # Modelos Mongoose │ └── examples/ # Ejemplos de uso │ ├── handlers/ # Lógica de negocio │ ├── index.js # Router de handlers │ ├── item.handler.js # Operaciones de items │ └── categoria.handler.js │ ├── tools/ # Definiciones MCP │ └── index.js # Registro de herramientas │ ├── server/ # Configuración servidor │ ├── index.js # Setup del servidor MCP │ └── config.js # Configuración │ └── mockups/ # Datos de prueba ├── categorias.mc.js └── items.mc.js

🛠️ Herramientas Disponibles

listar_items - Lista items con filtro opcional por categoría
buscar_item - Busca items por nombre
contar_items - Cuenta items y calcula totales
crear_items - Crea uno o más items
eliminar_item - Elimina un item por ID
actualizar_item - Actualiza un item existente
listar_categorias - Lista todas las categorías

📚 Documentación

ARCHITECTURE.md - Documentación detallada de la arquitectura
Ver ejemplos en src/database/examples/

🔄 Migración desde la versión anterior

Si estabas usando mcp-server.js:

Cambiar referencias: Actualiza cualquier script o configuración que apunte a mcp-server.js para que use index.js
Funcionalidad idéntica: Todas las herramientas funcionan igual, solo el código está mejor organizado
Beneficios:
- ✅ Código más organizado y fácil de mantener
- ✅ Separación de responsabilidades
- ✅ Más fácil agregar nuevas herramientas
- ✅ Soporte para múltiples bases de datos
- ✅ Mejor para testing

🧪 Testing

Probar todas las herramientas

node test-client.js

Probar con chat interactivo

export GROQ_API_KEY="tu-clave" node chat-groq.js

Ejemplo de conversación:

💬 Tú: Lista todos los items de electrónica 🤖 Groq: Aquí están los items de electrónica: - Laptop Dell (5 unidades) - $800 - Mouse Logitech (15 unidades) - $25 ...

🔐 Variables de Entorno

# MongoDB (opcional, default: mongodb://localhost:27017/inventario) export MONGODB_URI="mongodb://localhost:27017/inventario" # Groq API (solo para chat-groq.js) export GROQ_API_KEY="tu-api-key"

🆘 Troubleshooting

Error: "Cannot connect to MongoDB"

Verifica que MongoDB esté corriendo: mongosh
Verifica la URI de conexión

Error: "GROQ_API_KEY not found"

Solo necesario para chat-groq.js
Obtén tu API key en: https://console.groq.com

Error: "Module not found"