Simple Loki MCP Server

Co dělá “Simple Loki” MCP Server?

Simple Loki MCP Server je rozhraní Model Context Protocol (MCP), které umožňuje AI asistentům přímo dotazovat a analyzovat logy z instance Grafana Loki. Pomocí nástrojů jako logcli nebo alternativně Loki HTTP API umožňuje tento server hladkou integraci dat z logů do vývojových workflow. Podporuje plné dotazování v LogQL, získávání hodnot labelů a poskytuje naformátované výsledky v několika výstupních variantách (výchozí, raw, JSON lines). Díky flexibilní autentizaci a konfiguraci přes proměnné prostředí nebo konfigurační soubory je Simple Loki MCP Server ideální pro rozšíření observability, troubleshooting a monitoringu v AI aplikacích či automatizačních tocích.

Seznam promptů

V repozitáři ani dokumentaci nejsou uvedeny žádné explicitní šablony promptů.

Seznam resource

V repozitáři ani dokumentaci nejsou uvedeny žádné explicitní MCP resource.

Seznam nástrojů

• query-loki
  Dotazování logů z Loki s možností filtrování. Tento nástroj umožňuje uživatelům zadávat LogQL dotazy a získávat log záznamy, podporuje různé výstupní formáty a přístup k metadatům labelů.

Případy využití tohoto MCP serveru

• Analýza logů a troubleshooting
  Vývojáři mohou použít Simple Loki MCP Server pro analýzu a filtrování log dat z Grafana Loki, což usnadňuje debugování aplikací a šetření incidentů.
• Automatizovaná reakce na incidenty
  AI asistenti mohou automaticky získávat a sumarizovat relevantní logy během workflow řešení incidentů, čímž zvyšují rychlost a přesnost reakce.
• Observabilitní dashboardy
  Integrace dotazování na logy do vlastních dashboardů umožňuje získávat aktuální pohled na logy přímo ve vývojářských či monitorovacích nástrojích.
• Bezpečnostní monitoring
  AI agenti mohou sledovat logy na podezřelé vzory nebo aktivity, spouštět alerty nebo automatizované akce při detekci anomálií.
• Optimalizace výkonu
  Analýza historických logů pro identifikaci bottlenecků, chyb či trendů ovlivňujících výkonnost systému a proaktivní optimalizace.

Jak nastavit

Windsurf

1. Ujistěte se, že je nainstalován Node.js v16+.
2. Upravte svůj konfigurační soubor Windsurf (například settings.json).
3. Přidejte Simple Loki MCP Server do sekce mcpServers:

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

4. Uložte a restartujte Windsurf.
5. Ověřte běh serveru kontrolou funkce dotazování na logy.

Claude

1. Nainstalujte Node.js v16+.
2. Nainstalujte server pomocí Smithery:

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

3. Přidejte/aktualizujte konfiguraci Claude následovně:

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

4. Uložte a restartujte Claude.
5. Ověřte dostupnost dotazování na logy z Loki.

Cursor

1. Ověřte, že je nainstalován Node.js v16+.
2. Otevřete konfigurační soubor Cursor.
3. Vložte následující sekci pod mcpServers:

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

4. Uložte změny a restartujte Cursor.
5. Otestujte funkčnost dotazování na logy.

Cline

1. Ujistěte se, že je dostupný Node.js v16+.
2. Najděte a otevřete konfigurační soubor Cline.
3. Přidejte Simple Loki MCP položku:

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

4. Uložte a restartujte Cline.
5. Ověřte úspěšnou integraci dotazování na logy.

Zabezpečení API klíčů

Citlivé přihlašovací údaje (například LOKI_ADDR nebo tokeny) ukládejte do proměnných prostředí. Příklad:

{
  "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}"
      }
    }
  }
}

Jak použít tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do svého workflow ve FlowHunt začněte přidáním MCP komponenty do flow a jejím propojením s AI agentem:

Klikněte na MCP komponentu pro otevření panelu konfigurace. V sekci systémové MCP konfigurace vložte detaily vašeho MCP serveru v tomto JSON formátu:

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

Po konfiguraci může AI agent tento MCP využívat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “simple-loki” na skutečný název vašeho MCP serveru a URL na vaši adresu MCP serveru.

Přehled

Na základě výše uvedených tabulek je Simple Loki MCP Server zaměřený a funkční, ale postrádá šíři v podpoře promptů a resource. Snadno se nastavuje a má jasnou dokumentaci k integraci i zabezpečení API klíčů. Celkově je praktický pro dotazování na logy, ale omezený v pokročilých MCP schopnostech.

MCP skóre

Hodnocení:
Tento MCP server bych ohodnotil 6/10. Je solidní pro svůj účel a snadno integrovatelný, ale chybí mu rozmanitost v nástrojích, šablony promptů i explicitní definice resource, které jsou důležité pro širší využití MCP. Není zmíněna podpora Roots ani Sampling.