Conecta Oracle Database con Claude AI usando lenguaje natural. Kit completo de implementación: guía paso a paso, scripts de diagnóstico, configuración y consultas SQL de auditoría.
El Oracle MCP Server (disponible desde SQLcl 25.2+) permite que cualquier usuario autorizado consulte una base de datos Oracle usando lenguaje natural desde Claude Desktop o VS Code — sin escribir SQL, sin depender del DBA, con cada consulta auditada automáticamente en DBTOOLS$MCP_LOG.
Antes: "Necesito al DBA para saber cuántas facturas vencidas hay" Después: "¿Cuántas facturas tienen más de 30 días vencidas por cliente?" → SQL generado y ejecutado automáticamente.
oracle-ai-mcp-server/
│
├── README.md ← Este archivo
│
├── docs/
│ └── guia-implementacion.md ← Guía completa paso a paso
│
├── config/
│ ├── claude_desktop_config.json ← Template de configuración Claude Desktop
│ └── vscode_mcp_config.json ← Template para VS Code
│
├── scripts/
│ ├── oracle-mcp-diagnostico.ps1 ← Diagnóstico completo del sistema
│ ├── oracle-mcp-configurar-conexiones.ps1 ← Wizard de configuración
│ ├── oracle-mcp-pruebas.ps1 ← Suite de pruebas PASS/FAIL
│ └── INSTALAR.bat ← Instalador automatizado
│
└── sql/
├── crear_usuario_mcp.sql ← Crear usuario Oracle con menor privilegio
├── grant_permisos.sql ← Grants mínimos necesarios
└── validar_mcp_log.sql ← Consultas de auditoría
| Componente | Versión mínima | Verificar |
|---|---|---|
| Java | 17+ | java -version |
| SQLcl | 25.2+ | sql -v |
| Claude Desktop | Última | claude.ai/download |
| Oracle DB | 19c+ | Conectividad resuelta |
# 1. Clonar el repositorio
git clone https://github.com/jesmonsa/oracle-ai-mcp-server.git
cd oracle-ai-mcp-server
# 2. Ejecutar diagnóstico del sistema
.\scripts\oracle-mcp-diagnostico.ps1
# 3. Configurar conexión a la base de datos
.\scripts\oracle-mcp-configurar-conexiones.ps1
# 4. Copiar template de configuración a Claude Desktop
copy config\claude_desktop_config.json "%APPDATA%\Claude\claude_desktop_config.json"
# 5. Reiniciar Claude Desktop y probar📖 Para el paso a paso completo → docs/guia-implementacion.md
┌─────────────────────┐ ┌──────────────────────────┐
│ Claude Desktop │ ──MCP── │ SQLcl 25.2+ (MCP Srv) │
│ (o VS Code) │ │ sql.exe -mcp │
└─────────────────────┘ └────────────┬─────────────┘
│ JDBC / TNS
┌────────────▼─────────────┐
│ Oracle Database 19c+ │
│ (DBCS / ExaCS / ADB) │
└──────────────────────────┘
Flujo:
- Usuario escribe en lenguaje natural en Claude Desktop
- Claude genera SQL optimizado vía MCP Server (SQLcl)
- SQLcl ejecuta el SQL contra Oracle Database
- Resultado regresa a Claude → respuesta en lenguaje natural
- Cada consulta queda auditada en
DBTOOLS$MCP_LOG
Este kit sigue el principio de menor privilegio:
- El usuario MCP tiene solo
CONNECT+ grants específicos por schema - Sin acceso a
DBA_*ni vistas del sistema - Auditoría completa en
DBTOOLS$MCP_LOG - Credenciales en Connection Store local (nunca en texto plano)
Ver → sql/crear_usuario_mcp.sql
| Escenario | Soporte |
|---|---|
| Oracle DBCS Enterprise Edition en OCI | ✅ Completo |
| Oracle Autonomous Database (ADB) | ✅ Con wallet |
| Oracle 19c on-premise | ✅ Con EZConnect |
| Oracle ExaCS | ✅ Completo |
| Claude Desktop (Windows) | ✅ |
| VS Code + Continue.dev | ✅ |
| Mac / Linux | 🚧 En desarrollo |
Jesús Andrés Montoya Cloud Architect & Oracle Database Specialist — Oracle Cloud Infrastructure, Colombia & LATAM
Universal Permissive License v1.0 — ver LICENSE