Servidor Simple Loki MCP

O que faz o servidor “Simple Loki” MCP?

O Simple Loki MCP Server é uma interface Model Context Protocol (MCP) que permite que assistentes de IA consultem e analisem diretamente logs de uma instância Grafana Loki. Usando ferramentas como logcli ou recorrendo à API HTTP do Loki, este servidor possibilita a integração fluida de dados de logs em fluxos de desenvolvimento. Ele suporta consultas completas em LogQL, recuperação de valores de rótulos e fornece resultados formatados em diversas opções de saída (padrão, bruto, JSON lines). Com autenticação flexível e configuração via variáveis de ambiente ou arquivos de configuração, o Simple Loki MCP Server é ideal para aprimorar observabilidade, troubleshooting e monitoramento em aplicações com IA ou fluxos automatizados.

Lista de Prompts

Não há templates de prompt explícitos mencionados no repositório ou na documentação.

Lista de Recursos

Não há recursos MCP explícitos listados no repositório ou na documentação.

Lista de Ferramentas

• query-loki
  Consulta logs do Loki com opções de filtragem. Esta ferramenta permite que usuários enviem consultas LogQL e recuperem entradas de log, suportando diversos formatos de saída e acesso a metadados de rótulos.

Casos de Uso deste Servidor MCP

• Análise de Logs e Troubleshooting
  Desenvolvedores podem usar o Simple Loki MCP Server para analisar e filtrar dados de logs do Grafana Loki, facilitando o debug de aplicações e a investigação de problemas.
• Resposta Automatizada a Incidentes
  Assistentes de IA podem buscar e resumir automaticamente logs relevantes durante fluxos de incidentes, melhorando o tempo de resposta e precisão.
• Dashboards de Observabilidade
  Integre capacidade de consulta de logs em dashboards personalizados, permitindo insights em tempo real diretamente em ferramentas de desenvolvimento ou monitoramento.
• Monitoramento de Segurança
  Use agentes de IA para monitorar logs em busca de padrões ou atividades suspeitas, disparando alertas ou ações automáticas ao detectar anomalias.
• Otimização de Performance
  Analise dados históricos de logs para identificar gargalos, erros ou tendências que impactem a performance do sistema, auxiliando na otimização proativa.

Como configurar

Windsurf

1. Certifique-se de que o Node.js v16+ está instalado.
2. Edite o arquivo de configuração do Windsurf (por exemplo, settings.json).
3. Adicione o Simple Loki MCP Server à seção mcpServers:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Salve e reinicie o Windsurf.
5. Verifique se o servidor está funcionando conferindo a capacidade de consulta de logs.

Claude

1. Instale o Node.js v16+.
2. Use o Smithery para instalar o servidor:

   npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude
   

3. Adicione/atualize sua configuração do Claude conforme abaixo:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Salve e reinicie o Claude.
5. Confirme que a consulta de logs Loki está disponível.

Cursor

1. Confirme que o Node.js v16+ está instalado.
2. Abra o arquivo de configuração do Cursor.
3. Insira o seguinte em mcpServers:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Salve as alterações e reinicie o Cursor.
5. Teste a funcionalidade de consulta de logs.

Cline

1. Certifique-se de que o Node.js v16+ está disponível.
2. Localize e abra o arquivo de configuração do Cline.
3. Adicione a entrada do Simple Loki MCP:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Salve e reinicie o Cline.
5. Verifique a integração bem-sucedida da consulta de logs.

Protegendo Chaves de API

Armazene credenciais sensíveis (como LOKI_ADDR ou tokens) em variáveis de ambiente para segurança. Exemplo:

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "${LOKI_ADDR_ENV}",
        "LOKI_TOKEN": "${LOKI_TOKEN_ENV}"
      },
      "inputs": {
        "query": "${YOUR_LOGQL_QUERY}"
      }
    }
  }
}

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 do sistema MCP, insira os detalhes do seu servidor MCP neste formato JSON:

{
  "simple-loki": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “simple-loki” para o nome real do seu servidor MCP e substituir a URL pela URL do seu próprio servidor MCP.

Visão Geral

Com base na tabela acima, o Simple Loki MCP Server é focado e funcional, mas carece de amplitude em suporte a prompts e recursos. É fácil de configurar e possui documentação clara para integração e segurança de API key. No geral, é prático para consulta de logs, mas limitado em capacidades avançadas de MCP.

Pontuação MCP

Avaliação:
Eu avaliaria este servidor MCP com 6/10. Ele é sólido para sua finalidade e fácil de integrar, mas carece de variedade de ferramentas, templates de prompt e definições explícitas de recursos, que são essenciais para um uso mais amplo do MCP. Não menciona Roots nem suporte a Sampling.