Loki MCP Server

Čo robí „Loki“ MCP Server?

Loki MCP Server je implementácia Model Context Protocol (MCP) v Go určená na integráciu s Grafana Loki, systémom na agregáciu logov. Slúži ako most medzi AI asistentmi a externými zdrojmi logov, vďaka čomu môže AI dopytovať a pracovať s logovými prúdmi uloženými v Loki. Tým, že sprístupňuje možnosti dopytovania Loki cez MCP protokol, umožňuje vývojárom a AI klientom rozšíriť workflowy – napríklad vyhľadávanie, filtrovanie a analýzu logov – priamo cez štandardizované rozhrania riadené LLM. To umožňuje úlohy ako okamžité skúmanie logov, troubleshooting a tvorba dashboardov, čím poskytuje bezproblémový prístup k prevádzkovým dátam pre lepšiu observabilitu a automatizáciu.

Zoznam promptov

V repozitári nie sú zdokumentované žiadne prompt šablóny.

Zoznam zdrojov

V repozitári nie sú popísané žiadne explicitné MCP zdroje.

Zoznam nástrojov

• loki_query
  Umožňuje dopytovanie logov v Grafana Loki.
  • Povinné parametre:
    • query: LogQL dopytovací reťazec
  • Voliteľné parametre:
    • url: URL Loki servera (predvolene z LOKI_URL env alebo http://localhost:3100)
    • start: Začiatočný čas dopytu (predvolene: pred 1 hodinou)
    • end: Koncový čas dopytu (predvolene: teraz)
    • limit: Maximálny počet záznamov na vrátenie (predvolene: 100)

Prípady použitia tohto MCP servera

• Skúmanie logových dát
  Vývojári alebo AI agenti môžu programovo dopytovať a analyzovať logy uložené v Grafana Loki, čo pomáha pri riešení incidentov a troubleshooting-u.
• Automatizované monitorovanie logov
  Umožňuje workflowy riadené LLM, kde AI asistenti môžu prehľadávať logy na anomálie, chybové vzory alebo konkrétne udalosti.
• Operatívne dashboardy
  Zjednodušuje dynamickú tvorbu dashboardov získavaním logových dát potrebných pre vizualizačné alebo reportingové nástroje.
• Analýza príčin incidentov
  Umožňuje AI prehrabať sa veľkým objemom logov a flexibilnými LogQL dopytmi určiť pôvod problémov.

Ako ho nastaviť

Windsurf

1. Nainštalujte Go 1.16 alebo vyšší.

2. Zostavte server:
   go build -o loki-mcp-server ./cmd/server

3. Upravte svoju konfiguráciu Windsurf a pridajte MCP server.

4. Pridajte Loki MCP server cez JSON úryvok (prispôsobte podľa potreby):

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Uložte konfiguráciu a reštartujte Windsurf.

6. Overte, že server beží a je dostupný.

Zabezpečenie API kľúčov (príklad environmentálnych premenných):

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Claude

1. Nainštalujte Go 1.16 alebo vyšší.

2. Zostavte server ako vyššie.

3. Otvorte konfiguračný súbor Claude MCP.

4. Pridajte Loki MCP server:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Uložte/reštartujte Claude.

6. Overte funkčnosť nastavenia.

Zabezpečenie API kľúčov:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cursor

1. Uistite sa, že je nainštalovaný Go 1.16+.

2. Zostavte Loki MCP server.

3. Upravte konfiguráciu Cursor.

4. Pridajte položku Loki MCP servera:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Uložte a reštartujte Cursor.

6. Overte integráciu.

Použitie environmentálnych premenných:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cline

1. Nainštalujte Go >=1.16.

2. Zostavte príkazom:
   go build -o loki-mcp-server ./cmd/server

3. Vyhľadajte Cline MCP server konfiguráciu.

4. Pridajte Loki MCP server:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Uložte a reštartujte Cline.

6. Otestujte nastavenie.

Zabezpečte API kľúče cez env:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Ako používať tento MCP v tokoch

Použitie MCP vo FlowHunt

Ak chcete integrovať MCP servery do svojho FlowHunt workflowu, začnite pridaním MCP komponentu do toku a pripojte ho k svojmu AI agentovi:

Kliknite na MCP komponent pre otvorenie konfiguračného panela. V sekcii systémovej MCP konfigurácie vložte údaje MCP servera v tomto JSON formáte:

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

Po nakonfigurovaní bude môcť AI agent využívať tento MCP server ako nástroj s prístupom ku všetkým jeho funkciám. Nezabudnite zmeniť "loki-mcp" na skutočný názov vášho MCP servera a URL na vašu vlastnú adresu MCP servera.

Prehľad

Na základe vyššie uvedených tabuliek Loki MCP Server poskytuje jasný prehľad a funkčný nástroj na dopytovanie logov, ale chýbajú mu zdokumentované prompt šablóny, zdroje a pokročilé MCP funkcie ako sampling či roots. Dokumentácia je minimálna a nasadenie je orientované na vývojárov.

Náš názor

Loki MCP Server je zameraný a funkčný na integráciu LLM s dopytovaním logov do Grafana Loki, avšak je minimalisitický a chýba mu šírka MCP funkcionality a dokumentácie. Na hodnotenie by získal 4/10: spĺňa hlavný účel, no nie je to úplný, vyladený či bohato zdokumentovaný MCP server.

MCP Skóre