MCP Oracle Server

Este proyecto es un servidor Node.js que expone herramientas para interactuar con una base de datos Oracle a través del protocolo Model Context Protocol (MCP). Permite ejecutar consultas SELECT, describir tablas y listar tablas disponibles en la base de datos Oracle de forma segura y controlada.

¿Para qué sirve?

• Ejecutar consultas SELECT sobre una base de datos Oracle.
• Describir la estructura de cualquier tabla Oracle.
• Listar todas las tablas disponibles para el usuario conectado.
• Facilita la integración de bases de datos Oracle con herramientas que soportan MCP.

Requisitos

• Node.js >= 18
• Acceso a una base de datos Oracle
• Tener configuradas las variables de entorno para la conexión Oracle:
  • ORACLE_USER
  • ORACLE_PASSWORD
  • ORACLE_HOST
  • ORACLE_PORT
  • ORACLE_DATABASE

Instalación

1. Clona el repositorio:

   git clone https://github.com/YrsonHTM/mcp-oracle-server.git
   cd mcp-oracle-server
   

2. Instala las dependencias:

   npm install
   

Uso

Iniciar el servidor

npm start

El servidor se ejecutará y estará listo para recibir comandos MCP por stdio.

Herramientas disponibles

• execute_query: Ejecuta una consulta SELECT en Oracle.
• describe_table: Describe la estructura de una tabla.
• list_tables: Lista todas las tablas disponibles para el usuario.

Ejemplo de uso en Cursor

Puedes integrar este servidor con Cursor para interactuar con tu base de datos Oracle desde la propia interfaz de Cursor.

1. Configura el archivo mcp.json

Crea (o edita) el archivo mcp.json en la ruta c:\Users\<TU_USUARIO>\.cursor\mcp.json (en Windows) o ~/.cursor/mcp.json (en Linux/Mac). Ejemplo de configuración:

{
  "mcpServers": {
    "oracle-db": {
      "command": "node",
      "args": ["RUTA_DONDE_INSTALA_EL_SERVER: EJ: C:\\mcp-oracle-server\\server.js"],
      "env": {
        "ORACLE_HOST": "HOST_SERVER: EJ:10.10.10.10",
        "ORACLE_PORT": "PRT: EJ:1521",
        "ORACLE_DATABASE": "NOMBRE_BASE_DATOS: EJ:pruebadb",
        "ORACLE_USER": "NOMBRE_USUARIO: EJ:admin",
        "ORACLE_PASSWORD": "CONTRASEÑAñ EJ:1234"
      }
    }
  }
}

• Cambia las rutas y credenciales según tu entorno y base de datos.
• Asegúrate de que la ruta a server.js sea la correcta.

2. Agrega el servidor MCP en Cursor

• Abre Cursor.
• Ve a la configuración de MCP (Model Context Protocol).
• Haz clic en "Agregar servidor MCP" y selecciona el nombre que configuraste (por ejemplo, oracle-db).
• Inicia el servidor desde Cursor o manualmente con npm start.

3. Usa las herramientas desde Cursor

Ahora puedes ejecutar consultas, describir tablas y listar tablas directamente desde la interfaz de Cursor usando el servidor MCP que configuraste.

Notas

• El servidor solo permite consultas SELECT para evitar modificaciones accidentales en la base de datos.
• Si tienes problemas con la conexión Oracle, revisa que las variables de entorno estén correctamente configuradas.

Licencia

MIT