Legacy SQL Architect MCP

Servidor MCP que brinda a los agentes de IA un conocimiento profundo de bases de datos relacionales contemporáneas o heredadas.

GitHub

Prueba este MCPPatrocinado

Documentación

Legacy SQL Architect MCP

Servidor MCP que brinda a los agentes de IA un conocimiento profundo de bases de datos heredadas.

Conecta Claude Desktop (o cualquier cliente de IA compatible con MCP) a tu base de datos PostgreSQL, SQL Server u Oracle y deja que la IA inspeccione esquemas, lea procedimientos almacenados, analice el rendimiento de consultas, trace dependencias, genere documentación y produzca código Java funcional — todo en una sola conversación, sin que tengas que copiar ni una sola línea de SQL.

¿Por qué Legacy SQL Architect MCP?

Funciona con bases de datos heredadas, no solo con las modernas. Recuperación completa del código fuente de procedimientos almacenados, mapeo de dependencias de disparadores y análisis de impacto diseñados para bases de datos que llevan años o décadas en funcionamiento — incluidos paquetes PL/SQL de gran tamaño que otras herramientas no pueden manejar.

Solo lectura por diseño. Se conecta en modo estrictamente de solo lectura. Físicamente no puede modificar tu base de datos — sin INSERT, sin UPDATE, sin DELETE. Seguro para apuntar a producción.

Sin dependencia de frameworks. Sin Docker. Java puro + JDBC. Sin Spring, sin ORM, sin infraestructura que mantener. Se ejecuta como un instalador nativo ligero en Windows, macOS y Linux.

Combina estructura + lógica + datos reales en una sola conversación. La IA inspecciona el esquema, lee el procedimiento almacenado que procesa pedidos y luego toma muestras de pedidos reales para entender por qué algo está fallando — sin que tengas que copiar y pegar nada entre herramientas.

La IA comprende las relaciones, no solo las tablas. dependency_graph y find_impact rastrean cómo se conectan tablas, disparadores, procedimientos, vistas y claves foráneas — para que la IA te diga qué se rompe antes de que cambies nada.

Genera código Java funcional, no pseudocódigo. generate_java_dao produce clases Entity + Repository listas para compilar (JDBC puro, Java 17+) directamente desde tu esquema en vivo.

Bases de datos compatibles

Base de datos	Versión probada
PostgreSQL	11+
SQL Server	2016+ (Express, Standard, Enterprise)
Oracle	12c+

Herramientas disponibles

Herramienta	Qué hace
`inspect_schema`	Tablas, columnas, tipos, claves primarias, claves foráneas
`data_sampler`	Filas de muestra con enmascaramiento automático de columnas sensibles
`get_procedure_source`	Código fuente completo de procedimientos almacenados y funciones
`query_plan_expert`	Análisis del plan de ejecución, detección de escaneos completos de tabla
`dependency_graph`	Cadenas de claves foráneas, cadenas de llamadas disparador→procedimiento, dependencias de vistas
`generate_mermaid_erd`	Diagrama Entidad-Relación en formato Mermaid
`generate_documentation`	Documentación Markdown completa para todo el esquema
`find_impact`	Todo lo que depende de una tabla determinada
`generate_java_dao`	Clases Java Entity + Repository (JDBC puro) por tabla

Kit de herramientas Oracle APEX

Seis herramientas adicionales para diagnosticar el rendimiento de aplicaciones Oracle APEX (solo Oracle):

Herramienta	Qué hace
`inspect_apex_performance`	Resumen de app/página/región/LOV, páginas más lentas, recomendaciones de anti-patrones
`get_apex_source`	Extrae código APEX incrustado en 12 tipos de componentes (regiones, procesos, LOV, …)
`inspect_apex_debug`	Reconstruye vistas de página a partir de mensajes de depuración de APEX y profundiza en los pasos más lentos
`apex_config_audit`	Auditoría estática: paginación COUNT(*), max-rows sin límite, LOV sin caché, demasiados DA del lado del servidor
`apex_sql_runtime_stats`	Costo real de ejecución del SQL de una app desde V$SQL (buffer gets, tiempo transcurrido, ejecuciones)
`apex_explain_batch`	EXPLAIN PLAN por lotes del SQL de una app con detección de señales de alerta (escaneos completos, uniones cartesianas)

Inicio rápido

1. Instalación

Windows — descarga y ejecuta LegacySQLArchitectMCP-1.1.0.exe

Linux (Debian/Ubuntu)

sudo dpkg -i legacy-sql-architect-mcp_1.1.0_amd64.deb

Linux (RHEL/Fedora)

sudo rpm -i legacy-sql-architect-mcp-1.1.0-1.x86_64.rpm

macOS / JAR — requiere Java 21+

java -jar legacy-sql-architect-mcp.jar

2. Configura la conexión a la base de datos

Edita config.json en el directorio de instalación:

{
  "db_type": "postgresql",
  "db_url": "jdbc:postgresql://localhost:5432/your_database",
  "db_user": "your_user",
  "db_password": "your_password",
  "db_schema": "public",
  "data_sampler_rows": 10,
  "data_sampler_mask_sensitive": true
}

db_type acepta: postgresql, sqlserver, oracle

3. Añádelo a Claude Desktop

Edita %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "legacy-sql-architect": {
      "command": "C:\\Program Files\\LegacySQLArchitectMCP\\LegacySQLArchitectMCP.exe"
    }
  }
}

Reinicia Claude Desktop. Un icono de martillo (🔨) confirma que el servidor está activo.

4. Pruébalo

"Inspecciona el esquema y dame una visión general del modelo de datos."

"Obtén el código fuente de todos los procedimientos almacenados y resume la lógica de negocio."

"Necesito renombrar una columna en la tabla de pedidos — usa find_impact para decirme todo lo que se rompería."

Ejemplos de prompts

Inspect the schema, generate a Mermaid ERD, sample the orders table,
read all stored procedures, and produce complete Markdown documentation.

Analyze this query with query_plan_expert:
SELECT * FROM orders WHERE status = 'PENDING' AND created_at > '2024-01-01'
Is it using indexes? What would you recommend?

Generate Java DAO classes for all tables using package com.acme.repository,
then write each file into src/main/java/com/acme/repository/.

Build the dependency graph. When a row is inserted into orders,
what triggers fire and what procedures do they call?

Documentación

Guía de instalación — instalación, referencia de config.json, configuración de Claude Desktop, solución de problemas
Guía de usuario — todas las herramientas con ejemplos de prompts, flujos de trabajo con múltiples herramientas, consejos

Compilación desde el código fuente

Requiere Java 21 y Maven 3.8+.

# Run tests + build JAR
mvn clean package

# Windows installer (run on Windows, requires Java 21 with jpackage)
JAVA_HOME="c:/Java_21" mvn clean package -P windows-exe -Dmaven.test.skip=true

# Linux DEB (run inside Ubuntu/Debian container or system)
mvn clean package -P linux-deb -Dmaven.test.skip=true

# Linux RPM (run inside RHEL/Fedora container or system)
mvn clean package -P linux-rpm -Dmaven.test.skip=true

Las pruebas de integración usan PostgreSQL integrado — no se requiere Docker ni base de datos externa.

Distribución

Legacy SQL Architect MCP se distribuye como instaladores nativos — no como una biblioteca Maven. No hay ninguna dependencia que añadir a tu pom.xml. Descarga el instalador para tu plataforma desde GitHub Releases y sigue la Guía de instalación.

Licencia

Apache License 2.0 — consulta LICENSE