Exasol MCP

Servidor Exasol MCP

Fornece acesso de um LLM ao banco de dados Exasol por meio de ferramentas MCP. Inclui ferramentas para leitura de metadados do banco de dados e execução de consultas de leitura de dados.

🚀 Recursos

• Coleta os metadados.
  • Enumera os objetos existentes no banco de dados, incluindo schemas, tabelas, views, funções e scripts UDF.
    • Fornece mecanismos de filtragem para uso com a enumeração de objetos.
    • Descreve os objetos do banco de dados: para tabelas, retorna a lista de colunas e restrições; para funções e scripts, a lista de parâmetros de entrada e saída.
    • Permite pesquisa por palavras-chave nos objetos do banco de dados.
• Executa consultas SQL fornecidas.

A lista completa de ferramentas está formalmente descrita na seção Lista de Ferramentas do guia do usuário.

🔌️ Pré-requisitos

• Python >= 3.11
• Aplicativo cliente MCP, por exemplo, Claude Desktop

💾 Instalação

Garanta que o pacote uv esteja instalado. Em caso de dúvida, execute

uv --version

Para instalar o uv no macOS, use o brew, ou seja,

brew install uv

Para outros sistemas operacionais, siga as instruções na documentação oficial do uv.

🧠 Usando o servidor com o Claude Desktop

Para habilitar o Claude Desktop usando o servidor Exasol MCP, este deve estar listado no arquivo de configuração claude_desktop_config.json. Um arquivo de configuração semelhante existiria para a maioria dos outros aplicativos cliente MCP.

Para encontrar o arquivo de configuração do Claude Desktop, clique em Configurações e navegue até a aba "Developer". Esta seção contém opções para configurar servidores MCP e outros recursos de desenvolvimento. Clique no botão "Edit Config" para abrir o arquivo de configuração no editor de sua preferência.

Adicione o servidor Exasol MCP à lista de servidores MCP, conforme mostrado neste exemplo de configuração.

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

Com essas configurações, o uv executará a versão mais recente do exasol-mcp-server em um ambiente efêmero, sem instalá-lo.

Alternativamente, o exasol-mcp-server pode ser instalado usando o comando:

uv tool install exasol-mcp-server@latest

Para mais detalhes sobre instalação e atualização do servidor usando uv, consulte a documentação uv Tools.

Se o servidor estiver instalado, o arquivo de configuração do Claude deve ficar assim:

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

Observe que quaisquer alterações no arquivo de configuração do Claude só terão efeito após reiniciar o Claude Desktop.

🟠 🟢 Modos de execução

O servidor MCP pode ser implantado localmente, conforme descrito acima, ou como um servidor HTTP remoto. Para executar o servidor como um Direct HTTP Server, execute o comando:

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

O host padrão é 0.0.0.0.

Este comando fornece uma maneira simples de verificar a configuração para uma implantação remota do servidor MCP. Para o ambiente de produção, pode-se considerar o uso de um servidor ASGI como o Unicorn. A abordagem mais flexível é implementar um wrapper para o servidor Exasol MCP que fornecerá as opções de controle desejadas. Para mais informações e ideias, consulte HTTP Deployment na documentação do FastMCP.

Aqui está um exemplo de código que cria o servidor Exasol MCP a partir de um wrapper.

from exasol.ai.mcp.server import mcp_server

exasol_mcp = mcp_server()

🔧 Configurações

O servidor é configurado usando variáveis de ambiente e, opcionalmente, um arquivo json. No exemplo acima, o servidor recebe os parâmetros de conexão com o banco de dados, e todas as outras configurações ficam com os valores padrão. Para informações sobre como personalizar as configurações do servidor, consulte Server Setup no Guia do Usuário.

📜 Licença

Este projeto está licenciado sob a Licença MIT — consulte o arquivo LICENSE para obter detalhes.

Declaração de Safe Harbor: Servidor Exasol MCP e Soluções de IA

As soluções de IA da Exasol (incluindo o servidor MCP) são projetadas para permitir acesso inteligente, autônomo e de alto desempenho aos dados por meio de agentes baseados em IA e LLM. Embora essas tecnologias desbloqueiem novas capacidades poderosas, elas também introduzem riscos potencialmente significativos.

Ao conceder acesso de agentes de IA ao seu banco de dados, você reconhece que o comportamento de modelos de linguagem de grande porte (LLMs) e agentes autônomos não pode ser totalmente previsto ou controlado. Esses sistemas podem apresentar comportamento não intencional ou inseguro — incluindo, mas não se limitando a alucinações, suscetibilidade a prompts adversários e execução de ações imprevistas. Tal comportamento pode resultar em vazamento de dados, geração não autorizada de dados ou até mesmo modificação ou exclusão de dados.

A Exasol fornece as ferramentas para construir fluxos de trabalho nativos de IA; no entanto, você, como implementador e proprietário do sistema, assume total responsabilidade pelo gerenciamento dessas soluções em seu ambiente. Isso inclui estabelecer governança apropriada, controles de autorização, mecanismos de sandbox e salvaguardas operacionais para mitigar riscos para sua organização, seus clientes e seus dados.