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_USERORACLE_PASSWORDORACLE_HOSTORACLE_PORTORACLE_DATABASE
Instalación
-
Clona el repositorio:
git clone https://github.com/YrsonHTM/mcp-oracle-server.git cd mcp-oracle-server -
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.jssea 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