Package Exports

normalizacion-mcp-server
normalizacion-mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (normalizacion-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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