Legacy SQL Architect MCP
Servidor MCP que fornece aos agentes de IA um entendimento profundo de bancos
Documentação
Legacy SQL Architect MCP
Servidor MCP que dá a agentes de IA um entendimento profundo de bancos de dados legados.
Conecte o Claude Desktop (ou qualquer cliente de IA compatível com MCP) ao seu banco de dados PostgreSQL, SQL Server ou Oracle e deixe a IA inspecionar esquemas, ler procedures armazenadas, analisar desempenho de consultas, rastrear dependências, gerar documentação e produzir código Java funcional — tudo em uma única conversa, sem que você copie uma única linha de SQL.
Por que Legacy SQL Architect MCP?
Funciona com bancos de dados legados, não apenas com os modernos. Recuperação completa do código-fonte de stored procedures, mapeamento de dependências de triggers e análise de impacto projetados para bancos de dados que estão em produção há anos ou décadas — incluindo grandes pacotes PL/SQL que outras ferramentas não conseguem processar.
Somente leitura por design. Conecta-se em modo estritamente somente leitura. Fisicamente não consegue modificar seu banco de dados — sem INSERT, sem UPDATE, sem DELETE. Seguro para apontar para produção.
Sem amarras a frameworks. Sem Docker. Java puro + JDBC. Sem Spring, sem ORM, sem infraestrutura para manter. Executa como um instalador nativo leve no Windows, macOS e Linux.
Combina estrutura + lógica + dados reais em uma única conversa. A IA inspeciona o esquema, lê a stored procedure que processa pedidos e, em seguida, amostra pedidos reais para entender por que algo está quebrado — sem que você copie e cole nada entre ferramentas.
A IA entende relacionamentos, não apenas tabelas.
dependency_graph e find_impact rastreiam como tabelas, triggers, procedures, views e chaves estrangeiras se conectam — para que a IA diga o que quebra antes que você altere qualquer coisa.
Gera código Java funcional, não pseudocódigo.
generate_java_dao produz classes Entity + Repository prontas para compilar (JDBC puro, Java 17+) diretamente do seu esquema ativo.
Bancos de Dados Suportados
| Banco de Dados | Versão testada |
|---|---|
| PostgreSQL | 11+ |
| SQL Server | 2016+ (Express, Standard, Enterprise) |
| Oracle | 12c+ |
Ferramentas Disponíveis
| Ferramenta | O que faz |
|---|---|
inspect_schema | Tabelas, colunas, tipos, chaves primárias, chaves estrangeiras |
data_sampler | Linhas de amostra com mascaramento automático de colunas sensíveis |
get_procedure_source | Código-fonte completo de stored procedures e funções |
query_plan_expert | Análise de plano de execução, detecção de varredura total de tabela |
dependency_graph | Cadeias de FK, cadeias de chamadas trigger→procedure, dependências de views |
generate_mermaid_erd | Diagrama Entidade-Relacionamento em formato Mermaid |
generate_documentation | Documentação completa em Markdown para todo o esquema |
find_impact | Tudo que depende de uma determinada tabela |
generate_java_dao | Classes Java Entity + Repository (JDBC puro) por tabela |
Kit de ferramentas Oracle APEX
Seis ferramentas adicionais para diagnosticar o desempenho de aplicações Oracle APEX (somente Oracle):
| Ferramenta | O que faz |
|---|---|
inspect_apex_performance | Visão geral de app/página/região/LOV, páginas mais lentas, recomendações de anti-padrões |
get_apex_source | Extrai código APEX embutido em 12 tipos de componentes (regiões, processos, LOVs, …) |
inspect_apex_debug | Reconstrói visualizações de página a partir de mensagens de depuração do APEX e detalha as etapas mais lentas |
apex_config_audit | Auditoria estática: COUNT(*) de paginação, max-rows sem limite, LOVs sem cache, muitos DAs no lado do servidor |
apex_sql_runtime_stats | Custo real em tempo de execução do SQL de um app a partir do V$SQL (buffer gets, elapsed, executions) |
apex_explain_batch | EXPLAIN PLAN em lote do SQL de um app com detecção de bandeiras vermelhas (varreduras completas, junções cartesianas) |
Início Rápido
1. Instalação
Windows — baixe e execute 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 — requer Java 21+
java -jar legacy-sql-architect-mcp.jar
2. Configure a conexão com o banco de dados
Edite config.json no diretório de instalação:
{
"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 aceita: postgresql, sqlserver, oracle
3. Adicione ao Claude Desktop
Edite %APPDATA%\Claude\claude_desktop_config.json (Windows) ou ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"legacy-sql-architect": {
"command": "C:\\Program Files\\LegacySQLArchitectMCP\\LegacySQLArchitectMCP.exe"
}
}
}
Reinicie o Claude Desktop. Um ícone de martelo (🔨) confirma que o servidor está ativo.
4. Experimente
"Inspecione o esquema e me dê uma visão geral do modelo de dados."
"Obtenha o código-fonte de todas as stored procedures e resuma a lógica de negócios."
"Preciso renomear uma coluna na tabela de pedidos — use find_impact para me dizer tudo o que quebraria."
Exemplos 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?
Documentação
- Guia de Configuração — instalação, referência do config.json, configuração do Claude Desktop, solução de problemas
- Guia do Usuário — todas as ferramentas com exemplos de prompts, fluxos de trabalho com múltiplas ferramentas, dicas
Compilando a partir do Código-Fonte
Requer Java 21 e 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
Os testes de integração usam PostgreSQL embutido — sem Docker, sem necessidade de banco de dados externo.
Distribuição
Legacy SQL Architect MCP é distribuído como instaladores nativos — não como uma biblioteca Maven. Não há dependência para adicionar ao seu pom.xml. Baixe o instalador para sua plataforma em GitHub Releases e siga o Guia de Configuração.
Licença
Apache License 2.0 — veja LICENSE