OracleDB MCP Server

Un servidor MCP para interactuar con Oracle Database, que permite la generación de SQL y la recuperación de datos mediante indicaciones de LLM.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de OracleDB

Resumen

Este proyecto instalará MCP - Model Context Protocol Server, que proporciona tablas/columnas configuradas de Oracle Database como contexto para los LLM.
Con esto podemos permitir que los LLM interactúen con Oracle Database, generen sentencias SQL y devuelvan resultados usando indicaciones de LLM.

Instalación

Instalar el paquete
```
pip install oracledb_mcp_server
```
Crear un archivo .env en una carpeta con el valor mínimo de Oracle DB Connection String. Hay un archivo de muestra disponible aquí
Probar el servidor oracledb_mcp_server usando uv run oracledb_mcp_server desde la carpeta anterior.

Claud Desktop

Detalles de configuración para Claud Desktop

{
  "mcpServers": {
    "oracledb_mcp_server":{
      "command": "uv",
      "args": ["run","oracledb_mcp_server"],
      "env": {
          "DEBUG":"True",
          "COMMENT_DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME",
          "DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME",
          "TABLE_WHITE_LIST":"ACCOUNTS,CUS_ACC_RELATIONS,CUSTOMERS",
          "COLUMN_WHITE_LIST":"ACCOUNTS.ACC_AAD_ID,CUS_ACC_RELATIONS.CAR_CUS_ID,CUS_ACC_RELATIONS.CAR_AAD_ID,CUSTOMERS.CUS_ID"
      }
    }
  }
}

Configuración

Lista de variables de entorno disponibles
- DEBUG: Habilitar registro de depuración (opcional, el valor predeterminado es False)
- COMMENT_DB_CONNECTION_STRING: Cadena de conexión de Oracle DB para comentarios. (obligatorio)
- DB_CONNECTION_STRING: Cadena de conexión de Oracle DB para la ejecución de consultas. (obligatorio)
- TABLE_WHITE_LIST: Nombres de tablas en lista blanca en formato de lista ["tabla1", "tabla2"] (obligatorio)
- COLUMN_WHITE_LIST: Nombres de tabla-columna en lista blanca en formato de lista ["tabla.columna1", "tabla.columna2"] (obligatorio)
- QUERY_LIMIT_SIZE: El valor predeterminado es 10 registros si no se proporciona (opcional, el valor predeterminado es 10)

Interceptor

npx @modelcontextprotocol/inspector uv --directory "D:\\MyDev\\mcp\\oracledb_mcp_server" run -m oracledb_mcp_server

Contribuciones

Las contribuciones son bienvenidas.
No dudes en enviar una Solicitud de Extracción (Pull Request).

Licencia

Este proyecto está licenciado bajo los términos de la licencia MIT.