Loki MCP Server

Wat doet de “Loki” MCP Server?

De Loki MCP Server is een Go-implementatie van het Model Context Protocol (MCP) ontworpen om te integreren met Grafana Loki, een logaggregatiesysteem. Het fungeert als brug tussen AI-assistenten en externe logdata-bronnen, zodat de AI logstreams die in Loki zijn opgeslagen kan uitvragen en ermee kan interacteren. Door Loki’s querymogelijkheden via het MCP-protocol aan te bieden, kunnen ontwikkelaars en AI-clients hun workflows verbeteren—zoals zoeken, filteren en analyseren van logs—direct via gestandaardiseerde LLM-interfaces. Dit maakt onder andere realtime logonderzoek, troubleshooting en dashboardcreatie mogelijk, en biedt naadloze toegang tot operationele data voor betere observability en automatisering.

Lijst van Prompts

Er zijn geen prompt templates gedocumenteerd in de repository.

Lijst van Resources

Er zijn geen expliciete MCP-resources beschreven in de repository.

Lijst van Tools

• loki_query
  Hiermee kun je Grafana Loki logdata uitvragen.
  • Vereiste parameters:
    • query: LogQL-querystring
  • Optionele parameters:
    • url: Loki server URL (standaard van LOKI_URL env of http://localhost:3100)
    • start: Starttijd van de query (standaard: 1 uur geleden)
    • end: Eindtijd van de query (standaard: nu)
    • limit: Maximaal aantal teruggegeven entries (standaard: 100)

Use Cases van deze MCP Server

• Logdata-exploratie
  Ontwikkelaars of AI-agenten kunnen programmatisch logdata uit Grafana Loki uitvragen en analyseren, wat helpt bij troubleshooting en incidentrespons.
• Geautomatiseerde logmonitoring
  Maakt LLM-gedreven monitoring-workflows mogelijk, waarbij AI-assistenten logs scannen op afwijkingen, foutpatronen of specifieke gebeurtenissen.
• Operationele dashboards
  Maakt dynamische dashboardcreatie mogelijk door logdata op te halen die nodig is voor visualisatie- of rapportagetools.
• Root Cause Analysis
  Geeft AI de mogelijkheid om grote hoeveelheden logs te doorzoeken en de oorsprong van problemen te achterhalen met flexibele LogQL-queries.

Hoe stel je het in

Windsurf

1. Installeer Go 1.16 of hoger.

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

3. Bewerk je Windsurf-configuratie om de MCP-server toe te voegen.

4. Voeg de Loki MCP-server toe met een JSON-fragment (pas indien nodig aan):

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

5. Sla de configuratie op en herstart Windsurf.

6. Controleer of de server draait en bereikbaar is.

API-sleutels beveiligen (voorbeeld omgevingsvariabelen):

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

Claude

1. Installeer Go 1.16 of hoger.

2. Bouw de server zoals hierboven.

3. Open Claude’s MCP-configuratiebestand.

4. Voeg de Loki MCP-server toe:

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

5. Sla op/herstart Claude.

6. Controleer of de setup werkt.

API-sleutels beveiligen:

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

Cursor

1. Zorg dat Go 1.16+ is geïnstalleerd.

2. Bouw de Loki MCP-server.

3. Bewerk de Cursor-configuratie.

4. Voeg de Loki MCP-server toe:

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

5. Sla op en herstart Cursor.

6. Controleer de integratie.

Omgevingsvariabelen gebruiken:

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

Cline

1. Installeer Go >=1.16.

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

3. Zoek het MCP-serverconfiguratiebestand van Cline.

4. Voeg de Loki MCP-server toe:

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

5. Sla op en herstart Cline.

6. Test de setup.

API-sleutels beveiligen via env:

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

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, begin je met het toevoegen van de MCP-component aan je flow en verbind je deze met je AI-agent:

Klik op de MCP-component om het configuratiepaneel te openen. Voeg in de system MCP-configuratiesectie je MCP-servergegevens in met het volgende JSON-formaat:

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

Zodra geconfigureerd, kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet "loki-mcp" te wijzigen in de daadwerkelijke naam van je MCP-server en de URL te vervangen door je eigen MCP-server URL.

Overzicht

Op basis van bovenstaande tabel biedt Loki MCP Server een duidelijk overzicht en een functionele tool voor logquerying, maar ontbreken gedocumenteerde prompts, resources en geavanceerde MCP-features zoals sampling of roots. De documentatie is minimaal en de setup is gericht op ontwikkelaars.

Onze mening

De Loki MCP Server is doelgericht en functioneel voor het koppelen van LLM’s aan Grafana Loki logquerying, maar is minimalistisch en mist breedte in MCP-features en documentatie. Qua score krijgt het een 4/10: het doet waarvoor het bedoeld is, maar is geen feature-complete, gepolijste of rijk gedocumenteerde MCP-server.

MCP Score