oracle-sqlplus-mcp

Un servidor MCP (Model Context Protocol) para Oracle Database que utiliza sqlplus como backend de conexión. No se requieren enlaces de Node.js de Oracle Instant Client, solo un binario sqlplus funcional.

Requisitos previos

• sqlplus debe estar instalado y disponible en el PATH (se incluye con Oracle Instant Client o el cliente completo de Oracle)

• Node.js 18+

Related MCP server: oracle-db-mcp

Instalación

npm install -g oracle-sqlplus-mcp
# or run directly with npx (no install needed):
npx oracle-sqlplus-mcp

Formato de la cadena de conexión

username/password@host:port/servicename

Ejemplos:

scott/tiger@localhost:1521/ORCL
myuser/mypass@192.168.1.10:1521/XEPDB1
admin/secret@db.example.com:1521/PROD

Configuración de Claude Desktop

Añadir a su claude_desktop_config.json:

{
  "mcpServers": {
    "oracle": {
      "command": "npx",
      "args": ["-y", "oracle-sqlplus-mcp"],
      "env": {
        "ORACLE_CONNECTION": "username/password@host:port/servicename"
      }
    }
  }
}

Variables de entorno opcionales

Ejemplo de ruta personalizada de sqlplus

{
  "mcpServers": {
    "oracle": {
      "command": "npx",
      "args": ["-y", "oracle-sqlplus-mcp"],
      "env": {
        "ORACLE_CONNECTION": "scott/tiger@192.168.1.10:1521/ORCL",
        "SQLPLUS_PATH": "C:\\oracle\\instantclient_21_9\\sqlplus.exe",
        "QUERY_TIMEOUT_MS": "60000"
      }
    }
  }
}

Herramientas disponibles

Ejemplos de prompts

• "Prueba la conexión de Oracle"

• "Lista todos los esquemas en la base de datos"

• "Muéstrame las tablas en el esquema SCOTT"

• "Describe la tabla EMPLOYEES"

• "Obtén 5 filas de muestra de HR.EMPLOYEES"

• "Ejecuta esta consulta: SELECT * FROM departments WHERE department_id < 50"

• "Lista todos los procedimientos almacenados en el esquema HR"

Solución de problemas

sqlplus: command not found

Establezca SQLPLUS_PATH en la ruta completa de su binario sqlplus.

ORA-12541: TNS:no listener

Compruebe el host, el puerto y que el listener de Oracle esté en ejecución.

ORA-01017: invalid username/password

Verifique las credenciales. Formato de la cadena de conexión: user/pass@host:port/service.

SP2-0306: Invalid option

Asegúrese de que la versión de sqlplus admita el modo silencioso -S (todas las versiones modernas lo hacen).