README.md•1.5 kB
# MCP-Expokossodo 2025
Sistema MCP (Model Context Protocol) para gestión de eventos Expokossodo con FastAPI, SQLAlchemy y autenticación JWT.
## Características Principales
- 🔧 **7 Herramientas MCP**: getEventos, getInscritos, getAforo, confirmarAsistencia, getEstadisticas, buscarRegistro, mapaSalaEvento
- 🗃️ **Base de Datos Real**: Integración con MySQL (48 eventos, 1,010+ usuarios, 2,224+ inscripciones)
- 🛡️ **Seguridad**: Autenticación JWT con 3 roles (LECTOR, STAFF_PUERTA, COORDINADOR)
- 📊 **Logging Estructurado**: JSON logs con trace IDs
- ⚡ **Rate Limiting**: 10 rps lecturas, 3 rps escrituras
- 🐳 **Docker Ready**: Containerización incluida
## Instalación Rápida
```bash
# Clonar repositorio
git clone https://github.com/gfxjef/mcp_expokossodo2025.git
cd mcp_expokossodo2025
# Instalar dependencias
pip install -r requirements.txt
# Configurar base de datos
cp .env.example .env
# Editar .env con credenciales
# Iniciar servidor
python3 -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
# Generar tokens de prueba
python3 generate_token.py
# Probar herramientas MCP
./test_tools.sh
```
## Estado del Proyecto
✅ **Sistema Completamente Funcional**
- Todas las herramientas MCP operativas
- Conexión a base de datos real verificada
- Autenticación y permisos implementados
- Pruebas exitosas realizadas
🚀 **Listo para Producción**
Desarrollado para Expokossodo 2025 - Sistema de gestión de eventos y asistencia en tiempo real.