OracleDB MCP Server

Servidor MCP de OracleDB

Descripción general

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

Instalación

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

Escritorio de Claud

• 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 el registro de depuración (el valor predeterminado opcional es Falso)
  • COMMENT_DB_CONNECTION_STRING : Cadena de conexión de Oracle DB para comentarios. (obligatorio)
  • DB_CONNECTION_STRING : Cadena de conexión a la base de datos Oracle 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 columnas de tabla en lista blanca en formato de lista ["table.column1", "table.column2"] (obligatorio)
  • QUERY_LIMIT_SIZE : el valor predeterminado es 10 registros si no se proporciona (el valor predeterminado opcional es 10)

Interceptador

Contribuyendo

Las contribuciones son bienvenidas.
No dudes en enviar una solicitud de extracción.

Licencia

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

Manifestación

Estrellas de Github