MCP Oracle Database Server

Servidor MCP (Model Context Protocol) para integración completa con Oracle Database. Permite ejecutar consultas SQL, comandos DDL/DML, gestionar transacciones y explorar la estructura de la base de datos directamente desde aplicaciones MCP.

- Consultas SQL: Ejecuta SELECT con formateo inteligente de resultados
- Comandos DML/DDL: INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, etc.
- Gestión de Transacciones: Soporte para transacciones manuales y automáticas
- Exploración de BD: Lista tablas, describe estructuras, explora esquemas
- Pool de Conexiones: Gestión eficiente de conexiones con Oracle
- Compatibilidad: Soporte para versiones antiguas de Oracle (pre-12c)
- Monitoreo: Health checks y estadísticas de conexión

Verifica el estado de salud de la conexión Oracle DB.

Ejecuta consultas SQL SELECT con formato de tabla o JSON.

- Parámetros:sql,maxRows,formatAsTable,showMetadata

Ejecuta comandos SQL (INSERT, UPDATE, DELETE, CREATE, etc.).

- Parámetros:sql,autoCommit,showDetails

Lista todas las tablas del esquema especificado.

Muestra la estructura completa de una tabla.

- Parámetros:tableName,owner,showDetails

Ejecuta múltiples comandos SQL en una transacción.

Muestra información de configuración de la conexión.

⚠️IMPORTANTE: Para Oracle 9g y versiones antiguas

Si está usando Oracle 9g o versiones anteriores, debe realizar estos pasos adicionales:
- Descargar Oracle Instant Client 19.26(obligatorio para Oracle 9g):

- Windows:instantclient-basic-windows.x64-19.26.0.0.0dbru.zip
- Extraer a una carpeta (ej:C:\oracle\instantclient_19_26)
- Configurar la ruta:

ORACLE_CLIENT_LIB_DIR=C:\oracle\instantclient_19_26

{ "mcpServers": { "oracle-db": { "command": "npx", "args": ["@grec0/mcp-oracle-db"], "env": { "ORACLE_HOST": "tu-host-oracle", "ORACLE_PORT": "1521", "ORACLE_SERVICE_NAME": "tu-servicio", "ORACLE_USERNAME": "usuario", "ORACLE_PASSWORD": "contraseña", "ORACLE_OLD_CRYPTO": "true", "ORACLE_CLIENT_LIB_DIR": "C:\\oracle\\instantclient_19_26" } } } }

Instalación General MCP EN LOCAL (NO RECOMENDADO)

cp config.example.env .env # Editar .env con la configuración de su base de datos

Configuración MCP en Aplicaciones USANDO NPX (RECOMENDADO)

- Windows:%APPDATA%\Claude\claude_desktop_config.json
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Linux:~/.config/claude/claude_desktop_config.json

Configuración para Oracle 9g (con Instant Client 19.26):

{ "mcpServers": { "oracle-db": { "command": "npx", "args": ["@grec0/mcp-oracle-db"], "env": { "ORACLE_HOST": "tu-host-oracle", "ORACLE_PORT": "1521", "ORACLE_SERVICE_NAME": "tu-servicio", "ORACLE_USERNAME": "usuario", "ORACLE_PASSWORD": "contraseña", "ORACLE_OLD_CRYPTO": "true", "ORACLE_CLIENT_LIB_DIR": "C:\\oracle\\instantclient_19_26" } } } }

Configuración para Oracle 12c o superior:

{ "mcpServers": { "oracle-db": { "command": "npx", "args": ["@grec0/mcp-oracle-db"], "env": { "ORACLE_HOST": "host", "ORACLE_PORT": "port", "ORACLE_SERVICE_NAME": "service", "ORACLE_USERNAME": "user", "ORACLE_PASSWORD": "password" } } } }

{ "mcpServers": { "oracle-db": { "command": "node", "args": ["C:/workspaces/mcps/mcp-oracle-db/dist/index.js"], "env": { "ORACLE_HOST": "host", "ORACLE_PORT": "post", "ORACLE_SERVICE_NAME": "service", "ORACLE_USERNAME": "user", "ORACLE_PASSWORD": "pass", "ORACLE_OLD_CRYPTO": "true" } } } }

{ "mcpServers": { "oracle-db": { "command": "npm", "args": ["run", "dev"], "cwd": "C:/workspaces/mcps/mcp-oracle-db", "env": { "ORACLE_HOST": "localhost", "ORACLE_PORT": "1521", "ORACLE_SERVICE_NAME": "XE", "ORACLE_USERNAME": "hr", "ORACLE_PASSWORD": "hr" } } } }

Después de configurar el MCP, puedes verificar que funciona correctamente:
- Reiniciar la aplicación(Claude Desktop, etc.)
- Usar herramienta de diagnóstico:

oracle_health_check()

oracle_query("SELECT 1 FROM DUAL")

# Configuración básica ORACLE_HOST=localhost ORACLE_PORT=1521 ORACLE_SERVICE_NAME=XE ORACLE_USERNAME=hr ORACLE_PASSWORD=hr # O usar connection string completo ORACLE_CONNECTION_STRING="(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=XE)))" # Para versiones antiguas de Oracle (pre-11g) ORACLE_OLD_CRYPTO=true ORACLE_CLIENT_LIB_DIR=/path/to/instantclient

Basado en la configuración Java proporcionada:

ORACLE_HOST=host ORACLE_PORT=port ORACLE_SERVICE_NAME=service ORACLE_USERNAME=user ORACLE_PASSWORD=password ORACLE_OLD_CRYPTO=true ORACLE_FETCH_SIZE=100 # Basado en DataSourceCrmConfig.java

ORACLE_POOL_MIN=2 ORACLE_POOL_MAX=10 ORACLE_POOL_INCREMENT=1 ORACLE_POOL_TIMEOUT=60 ORACLE_STMT_CACHE_SIZE=30

SELECT * FROM employees WHERE department_id = 10

CREATE TABLE test_table ( id NUMBER PRIMARY KEY, name VARCHAR2(100) NOT NULL, created_date DATE DEFAULT SYSDATE )

INSERT INTO test_table (id, name) VALUES (1, 'Test Record')

-- Comando 1 INSERT INTO customers (id, name) VALUES (1, 'Cliente Test'); -- Comando 2 UPDATE orders SET customer_id = 1 WHERE id = 100; -- Comando 3 DELETE FROM temp_data WHERE processed = 'Y';

⚠️ Error Oracle 9g: Password Verifier Not Supported

Si obtiene el error "password verifier type 0x939 is not supported by node-oracledb in Thin mode" conOracle 9g:

📦 Paso 1: Descargar Oracle Instant Client 19.26

# Descargar desde: # https://download.oracle.com/otn_software/nt/instantclient/1926000/instantclient-basic-windows.x64-19.26.0.0.0dbru.zip # Extraer a: C:\oracle\instantclient_19_26

⚙️ Paso 2: Configurar variables obligatorias

ORACLE_OLD_CRYPTO=true ORACLE_CLIENT_LIB_DIR=C:\oracle\instantclient_19_26

🚀 Para versiones Oracle 10g-11g: Probar sin Instant Client primero

📦 Si falla con 10g-11g, instalar Oracle Instant Client

- Windows:Oracle Instant Client para Windows
- Linux:Oracle Instant Client para Linux
- macOS:Oracle Instant Client para macOS

ORACLE_CLIENT_LIB_DIR=/path/to/instantclient

ORACLE_HOST=your-oracle-host ORACLE_PORT=1521 ORACLE_SERVICE_NAME=your-service ORACLE_USERNAME=username ORACLE_PASSWORD=password ORACLE_OLD_CRYPTO=true

ORACLE_HOST=your-oracle-host ORACLE_PORT=1521 ORACLE_SERVICE_NAME=your-service ORACLE_USERNAME=username ORACLE_PASSWORD=password ORACLE_OLD_CRYPTO=true ORACLE_CLIENT_LIB_DIR=/opt/oracle/instantclient_19_8

# Ubuntu/Debian wget https://download.oracle.com/otn_software/linux/instantclient/XXX/instantclient-basic-linux.x64-XX.Y.Z.zip unzip instantclient-basic-linux.x64-XX.Y.Z.zip export ORACLE_CLIENT_LIB_DIR=/opt/oracle/instantclient_XX_Y

# Descargar desde Oracle y extraer export ORACLE_CLIENT_LIB_DIR=/opt/oracle/instantclient_XX_Y

# Ajustar configuración del pool ORACLE_POOL_MIN=1 ORACLE_POOL_MAX=5 ORACLE_POOL_TIMEOUT=30

MIT License - verLICENSEpara más detalles.

- GitHub Issues:github.com/gcorroto/mcp-oracle-db/issues

- Oracle Database Documentation
- node-oracledb Documentation
- Model Context Protocol

Multi-database agent access (PostgreSQL, SQLite, MySQL, Oracle, SQL Server) with batch queries, pre-configured connections, and SQLGlot-enforced read-only safety