mcp-oracle-server

# 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