Exasol MCP

Servidor Exasol MCP

Proporciona a un LLM acceso a la base de datos Exasol a través de herramientas MCP. Incluye las herramientas para leer los metadatos de la base de datos y ejecutar consultas de lectura de datos.

🚀 Características

• Recopila los metadatos.
  • Enumera los objetos de base de datos existentes, incluyendo esquemas, tablas, vistas, funciones y scripts UDF.
    • Proporciona mecanismos de filtrado para usar con la enumeración de objetos.
    • Describe los objetos de base de datos: para tablas devuelve la lista de columnas y restricciones; para funciones y scripts, la lista de parámetros de entrada y salida.
    • Permite la búsqueda por palabras clave de objetos de base de datos.
• Ejecuta la consulta SQL proporcionada.

La lista completa de herramientas se describe formalmente en la sección Lista de Herramientas de la guía del usuario.

🔌️ Requisitos previos

• Python >= 3.11
• Aplicación de cliente MCP, por ejemplo, Claude Desktop

💾 Instalación

Asegúrese de que el paquete uv esté instalado. Si tiene dudas, ejecute

uv --version

Para instalar uv en macOS, use brew, es decir,

brew install uv

Para otros sistemas operativos, siga las instrucciones en la documentación oficial de uv.

🧠 Uso del servidor con Claude Desktop

Para habilitar Claude Desktop usando el servidor Exasol MCP, este debe estar listado en el archivo de configuración claude_desktop_config.json. Un archivo de configuración similar existiría para la mayoría de las otras aplicaciones de cliente MCP.

Para encontrar el archivo de configuración de Claude Desktop, haga clic en Configuración y navegue hasta la pestaña “Desarrollador”. Esta sección contiene opciones para configurar servidores MCP y otras características de desarrollador. Haga clic en el botón “Editar Config” para abrir el archivo de configuración en el editor de su elección.

Agregue el servidor Exasol MCP a la lista de servidores MCP como se muestra en este ejemplo de configuración.

{
    "mcpServers": {
        "exasol_db": {
            "command": "uvx",
            "args": ["exasol-mcp-server@latest"],
            "env": {
                "EXA_DSN": "my-dsn",
                "EXA_USER": "my-user-name",
                "EXA_PASSWORD": "my-password"
            }
        }
    }
}

Con esta configuración, uv ejecutará la última versión de exasol-mcp-server en un entorno efímero, sin instalarlo.

Alternativamente, exasol-mcp-server se puede instalar usando el comando:

uv tool install exasol-mcp-server@latest

Para más detalles sobre la instalación y actualización del servidor usando uv, consulte la documentación de Herramientas uv.

Si el servidor está instalado, el archivo de configuración de Claude debería verse así:

{
    "mcpServers": {
        "exasol_db": {
            "command": "exasol-mcp-server",
            "env": "same as above"
        }
    }
}

Tenga en cuenta que cualquier cambio en el archivo de configuración de Claude solo tendrá efecto después de reiniciar Claude Desktop.

🟠 🟢 Modos de ejecución

El servidor MCP se puede implementar localmente, como se describió anteriormente, o como un servidor HTTP remoto. Para ejecutar el servidor como un Servidor HTTP Directo, ejecute el comando:

exasol-mcp-server-http --host <server-host> --port <server-port>

El host por defecto es 0.0.0.0.

Este comando proporciona una forma sencilla de verificar la configuración para un despliegue remoto de un servidor MCP. Para el entorno de producción, se podría considerar usar un servidor ASGI como Unicorn. El enfoque más flexible es implementar un envoltorio para el servidor Exasol MCP que proporcione las opciones de control deseadas. Para más información e ideas, consulte el Despliegue HTTP en la documentación de FastMCP.

Aquí hay un ejemplo de código que crea el servidor Exasol MCP desde un envoltorio.

from exasol.ai.mcp.server import mcp_server

exasol_mcp = mcp_server()

🔧 Configuración

El servidor se configura usando variables de entorno y opcionalmente un archivo json. En el ejemplo anterior, al servidor se le proporcionan los parámetros de conexión a la base de datos, dejando el resto de la configuración por defecto. Para obtener información sobre cómo personalizar la configuración del servidor, consulte la Configuración del Servidor en la Guía del Usuario.

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulte el archivo LICENSE para más detalles.

Declaración de Puerto Seguro: Servidor Exasol MCP y Soluciones de IA

Las soluciones de IA de Exasol (incluido el Servidor MCP) están diseñadas para permitir un acceso inteligente, autónomo y de alto rendimiento a los datos a través de agentes impulsados por IA y LLM. Si bien estas tecnologías desbloquean nuevas capacidades poderosas, también introducen riesgos potencialmente significativos.

Al otorgar a los agentes de IA acceso a su base de datos, usted reconoce que el comportamiento de los modelos de lenguaje grandes (LLM) y los agentes autónomos no se puede predecir ni controlar por completo. Estos sistemas pueden exhibir un comportamiento no intencionado o inseguro, incluidos, entre otros, alucinaciones, susceptibilidad a indicaciones adversas y la ejecución de acciones imprevistas. Dicho comportamiento puede resultar en fuga de datos, generación no autorizada de datos, o incluso modificación o eliminación de datos.

Exasol proporciona las herramientas para construir flujos de trabajo nativos de IA; sin embargo, usted, como implementador y propietario del sistema, asume la responsabilidad total de gestionar estas soluciones dentro de su entorno. Esto incluye establecer gobernanza adecuada, controles de autorización, mecanismos de sandboxing y salvaguardas operativas para mitigar los riesgos para su organización, sus clientes y sus datos.