Servidor MCP para Normalización de Bases de Datos

Este servidor MCP (Model Context Protocol) te ayuda a normalizar tablas de bases de datos siguiendo las formas normales 1FN, 2FN y 3FN. Está basado en el contexto educativo proporcionado y sigue las mejores prácticas de normalización de bases de datos.

🎯 Características

• Análisis de Primera Forma Normal (1FN): Identifica y corrige grupos repetitivos
• Análisis de Segunda Forma Normal (2FN): Detecta dependencias parciales en claves compuestas
• Análisis de Tercera Forma Normal (3FN): Identifica dependencias transitivas
• Normalización automática: Sugiere la estructura de tablas normalizadas
• Ejemplos educativos: Proporciona ejemplos paso a paso del proceso de normalización
• Análisis de anomalías: Detecta inconsistencias y redundancias en los datos
• Explicaciones detalladas: Proporciona teoría y conceptos de normalización

🚀 Instalación

# Clonar o descargar el proyecto
cd normalizacion-mcp-server

# Instalar dependencias
npm install

# Compilar el proyecto
npm run build

📖 Uso

Como servidor MCP independiente

npm start

En desarrollo (con recarga automática)

npm run dev

Ejecutar pruebas

node test.js

Herramientas disponibles

analizar_tabla

Analiza una tabla y determina en qué forma normal se encuentra.

Parámetros:

• tabla: Nombre de la tabla
• columnas: Array de columnas con sus tipos
• datos_ejemplo: Datos de ejemplo para el análisis
• clave_primaria: Definición de la clave primaria

normalizar_1fn

Normaliza una tabla a Primera Forma Normal eliminando grupos repetitivos.

normalizar_2fn

Normaliza una tabla a Segunda Forma Normal eliminando dependencias parciales.

normalizar_3fn

Normaliza una tabla a Tercera Forma Normal eliminando dependencias transitivas.

explicar_normalizacion

Proporciona explicaciones detalladas sobre el proceso de normalización.

generar_ejemplo

Genera ejemplos educativos del proceso de normalización.

⚙️ Configuración y uso

Uso como servidor MCP (integración con VS Code u otros entornos)

Puedes configurar el servidor para que se ejecute localmente, por ejemplo en VS Code, agregando en tu configuración:

"mcp": {
  "servers": {
    "normalizacion": {
      "command": "npx",
      "args": ["normalizacion-mcp-server"],
      "env": {}
    }
  }
}

Esto levantará el servidor MCP de normalización y podrás interactuar con él desde tu editor o cualquier cliente MCP compatible.

Uso como herramienta CLI desde npm/npx

Si prefieres usarlo como herramienta de línea de comandos para procesar archivos directamente:

npx normalizacion-mcp-server analizar -a productos.csv
npx normalizacion-mcp-server normalizar_1fn -a productos.csv -o productos_1fn.csv

• analizar: Analiza la forma normal de la tabla.
• normalizar_1fn: Normaliza a 1FN.
• -a, --archivo: Archivo de entrada (CSV o JSON).
• -o, --salida: Archivo/carpeta de salida (opcional).

No necesitas modificar la configuración de tu editor para este modo, solo ejecuta el comando desde la terminal donde tengas el archivo.

Uso local (sin publicar en npm)

Puedes ejecutar el servidor o la herramienta CLI directamente desde el proyecto clonado:

# Ejecutar el servidor MCP localmente
node dist/index.js

# O usarlo como CLI para analizar o normalizar archivos
node dist/index.js analizar -a productos.csv
node dist/index.js normalizar_1fn -a productos.csv -o productos_1fn.csv

Esto es útil para desarrollo, pruebas o integración en tu propio entorno antes de publicarlo en npm.

Licencia

MIT