normalizacion-mcp-server

CarlosMS12/normalizacion-mcp-server

3.2

If you are the rightful owner of normalizacion-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This MCP server assists in normalizing database tables according to 1NF, 2NF, and 3NF, based on educational context and best practices.

Tools

  1. analizar_tabla

    Analyzes a table to determine its normal form.

  2. normalizar_1fn

    Normalizes a table to First Normal Form by removing repetitive groups.

  3. normalizar_2fn

    Normalizes a table to Second Normal Form by removing partial dependencies.

  4. normalizar_3fn

    Normalizes a table to Third Normal Form by removing transitive dependencies.

  5. explicar_normalizacion

    Provides detailed explanations of the normalization process.

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