# 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:**
   ```sh
   git clone https://github.com/YrsonHTM/mcp-oracle-server.git
   cd mcp-oracle-server
   ```

2. **Instala las dependencias:**
   ```sh
   npm install
   ```

## Uso

### Iniciar el servidor
```sh
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](https://www.cursor.so/) 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:

```json
{
  "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