MySQL MCP Server v2

Este servidor MCP (Message Control Protocol) proporciona una interfaz para gestionar y consultar información de presupuestos departamentales a través de una base de datos MySQL.

Características

Conexión segura a base de datos MySQL
Gestión de presupuestos departamentales
Consultas por código de departamento
Búsqueda por nombre de departamento
Registro de solicitudes de presupuesto
Manejo robusto de errores y conexiones

Related MCP server: Gatherings MCP Server

Requisitos

Python 3.6 o superior
MySQL Server (XAMPP o similar)
Paquetes Python requeridos:
- mcp
- mysql-connector-python

Instalación

Clonar el repositorio
Instalar las dependencias:

pip install mcp mysql-connector-python

Configuración

El servidor está configurado para conectarse a una base de datos MySQL con los siguientes parámetros por defecto:

db_config = { 'host': 'localhost', 'port': 3306, 'user': 'reporte', 'password': 'reporte', 'database': '_REPORTE', 'raise_on_warnings': True }

Ajusta estos parámetros según tu configuración de base de datos.

Funcionalidades

1. Consulta de Estado Completo

get_estado_completo(codigo: int)

Retorna la información completa de un departamento por su código, incluyendo:

Código
Nombre
Presupuesto inicial
Monto solicitado
Saldo disponible
Monto pagado

2. Registro de Solicitudes

registrar_solicitud(codigo: int, monto: float)

Registra una nueva solicitud de presupuesto para un departamento:

Actualiza el monto solicitado
Recalcula el saldo disponible
Maneja transacciones de forma segura

3. Búsqueda por Nombre

buscar_por_nombre(nombre: str)

Busca departamentos por nombre:

Búsqueda parcial (usando LIKE)
Retorna múltiples resultados
Incluye información completa de cada departamento encontrado

Pruebas

El proyecto incluye scripts de prueba para verificar la funcionalidad:

test_buscar_nombre.py: Prueba la funcionalidad de búsqueda por nombre
Ejecuta las pruebas con:

python test_buscar_nombre.py

Manejo de Errores

El servidor implementa un manejo robusto de errores:

Errores de conexión a la base de datos
Errores de consulta
Validación de datos
Rollback automático en caso de errores en transacciones

Estructura de la Base de Datos

La tabla principal departamentos contiene los siguientes campos:

codigo (int): Identificador único del departamento
nombre (varchar): Nombre del departamento
inicial (decimal): Presupuesto inicial
solicitado (decimal): Monto solicitado
saldo (decimal): Saldo disponible
pagado (decimal): Monto pagado

Ejecución

Para iniciar el servidor:

python mysql_mcp_server_v2.py

Notas de Seguridad

Las credenciales de la base de datos están hardcodeadas en el código. En un entorno de producción, se recomienda usar variables de entorno o un archivo de configuración seguro.
Se implementa manejo de conexiones seguro usando el patrón context manager.
Las transacciones se manejan con commit/rollback apropiados.