# 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
