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.

Related MCP server: MCP Oracle Server

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

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

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