Integração com o Doris MCP Server

O que faz o servidor “Doris” MCP?

O Doris MCP (Model Context Protocol) Server é um serviço backend construído em Python e FastAPI, projetado para conectar assistentes de IA e clientes a bancos de dados Apache Doris. Ao implementar o padrão MCP, facilita interações seguras e eficientes entre modelos de linguagem e fontes externas de dados. O Doris MCP Server permite tarefas como converter consultas em linguagem natural em SQL (NL2SQL), executar consultas no banco de dados, recuperar e gerenciar metadados e realizar monitoramento e análises avançadas. Sua arquitetura modular inclui gerenciadores dedicados para ferramentas, prompts e recursos, tornando-o uma solução robusta para aprimorar fluxos de desenvolvimento de dados, automatizar a gestão de bancos de dados e integrar insights orientados por IA em sistemas empresariais.

Lista de Prompts

• Modelos inteligentes de prompts para análise de dados
  (Estes são gerenciados pelo Prompts Manager e são projetados para padronizar interações com LLMs em tarefas de análise de dados. Modelos específicos são referenciados, mas não listados individualmente na documentação disponível.)

Lista de Recursos

• Gerenciamento de recursos e exposição de metadados
  (Expõe metadados e recursos do banco de dados Doris para clientes de IA via Resources Manager.)
• Suporte à Federação de Catálogos
  (Permite acesso tanto a tabelas internas do Doris quanto a fontes externas como Hive e MySQL.)
• Metadados abrangentes do banco de dados
  (Fornece extração detalhada de metadados para uso como contexto de LLM.)
• Artefatos de Análise de Consultas
  (Exporta resultados de explain e profiling de consultas para anexação e análise por LLM.)

Lista de Ferramentas

• Ferramentas de monitoramento aprimoradas
  (Rastreamento avançado de memória, coleta de métricas e descoberta de nós de backend.)
• Ferramentas de informações de consulta
  (Fornece recursos de explain, profiling e análises de SQL.)
• Gerenciador de Ferramentas
  (Interface central de registro e roteamento de ferramentas para orquestrar chamadas via MCP.)
• Gerenciador de Recursos
  (Gerencia exposição de recursos e administração de metadados.)
• Gerenciador de Prompts
  (Gerencia e fornece modelos de prompts para fluxos de trabalho de IA e LLM.)

Casos de Uso deste MCP Server

• Natural Language to SQL (NL2SQL):
  Permite que desenvolvedores convertam consultas em linguagem humana em instruções SQL para bancos Doris, facilitando o acesso e análise de dados.
• Monitoramento e Profiling Avançados de Consultas:
  Fornece ferramentas detalhadas de explain de SQL, profiling de performance e análises, auxiliando em ajustes e diagnósticos de performance.
• Exploração e Gestão de Metadados:
  Permite que sistemas baseados em IA explorem esquemas, catálogos e recursos do banco, suportando tarefas como geração de documentação ou mapeamento automático de dados.
• Integração de Dados Multi-fonte:
  Suporta federação de catálogos, permitindo integração transparente com fontes externas (ex: Hive, MySQL) para fluxos analíticos abrangentes.
• Operações Seguras com Dados:
  Implementa segurança robusta, controle de acesso e mascaramento de dados, garantindo interações seguras entre LLMs e dados sensíveis empresariais.

Como configurar

Windsurf

1. Certifique-se de que o Python 3.12+ está instalado.

2. Instale o pacote:
   pip install mcp-doris-server@latest

3. Edite o arquivo de configuração do Windsurf para adicionar o Doris MCP server.

4. Insira o seguinte trecho sob mcpServers:

   {
     "doris-mcp": {
       "command": "mcp-doris-server",
       "args": []
     }
   }
   

5. Salve e reinicie o Windsurf.

6. Verifique se o servidor está funcionando e aceitando conexões.

Claude

1. Instale o Python 3.12+.

2. Instale o Doris MCP server:
   pip install mcp-doris-server@latest

3. Adicione o servidor à configuração do Claude em mcpServers.

4. Use um trecho JSON como este:

   {
     "doris-mcp": {
       "command": "mcp-doris-server",
       "args": []
     }
   }
   

5. Reinicie o Claude e verifique a integração.

Cursor

1. Certifique-se de que o Python 3.12+ está instalado.

2. Instale o servidor:
   pip install mcp-doris-server@latest

3. Na configuração do Cursor, adicione:

   {
     "mcpServers": {
       "doris-mcp": {
         "command": "mcp-doris-server",
         "args": []
       }
     }
   }
   

4. Salve a configuração e reinicie o Cursor.

5. Confirme a conexão com o Doris MCP server.

Cline

1. Instale o Python 3.12+.

2. Instale o Doris MCP server:
   pip install mcp-doris-server@latest

3. Atualize a configuração MCP do Cline com:

   {
     "mcpServers": {
       "doris-mcp": {
         "command": "mcp-doris-server",
         "args": []
       }
     }
   }
   

4. Salve a configuração e reinicie o Cline.

5. Verifique o status do servidor MCP.

Protegendo Chaves de API

Armazene credenciais sensíveis e chaves de API em variáveis de ambiente. Exemplo usando .env:

{
  "env": {
    "DORIS_HOST": "seu-doris-host",
    "DORIS_PORT": "sua-porta",
    "DORIS_USER": "usuario",
    "DORIS_PASSWORD": "senha"
  },
  "inputs": {
    "database": "seu-banco"
  }
}

Certifique-se de referenciar as variáveis de ambiente na configuração para maior segurança.

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "doris-mcp": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparamcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como ferramenta, com acesso a todas as suas funções e capacidades. Lembre-se de trocar “doris-mcp” pelo nome real do seu servidor MCP e atualizar a URL conforme necessário.

Visão geral

Com base nas informações acima, o Doris MCP Server está bem documentado em termos de funcionalidades, recursos e configuração. No entanto, alguns detalhes sobre modelos de prompts e suporte à amostragem estão ausentes ou não explicitamente listados, o que limita um pouco sua completude para fluxos MCP avançados.

Nossa opinião

Dada a forte presença dos recursos MCP essenciais, segurança robusta, gestão de recursos e orientações claras de configuração, o Doris MCP Server recebe nota 8/10 para suporte ao protocolo MCP e aplicação prática. As lacunas dizem respeito principalmente à listagem explícita de prompts e à ausência de documentação sobre sampling/roots.

Pontuação MCP