Loki MCP Server

Hva gjør “Loki” MCP Server?

Loki MCP-serveren er en Go-basert implementasjon av Model Context Protocol (MCP) laget for å integreres med Grafana Loki, et loggaggregasjonssystem. Den fungerer som en bro mellom AI-assistenter og eksterne loggdatakilder, slik at AI-en kan spørre og samhandle med loggstrømmer lagret i Loki. Ved å eksponere Lokis spørringsfunksjonalitet via MCP-protokollen, kan utviklere og AI-klienter forbedre arbeidsflytene sine – for eksempel søk, filtrering og analyse av logger – direkte gjennom standardiserte LLM-baserte grensesnitt. Dette muliggjør oppgaver som sanntids loggundersøkelse, feilsøking og dashbordopprettelse, og gir sømløs tilgang til operasjonelle data for bedre observabilitet og automatisering.

Liste over Promptmaler

Ingen promptmaler er dokumentert i depotet.

Liste over ressurser

Ingen eksplisitte MCP-ressurser er beskrevet i depotet.

Liste over verktøy

• loki_query
  Gjør det mulig å spørre Grafana Loki-loggdata.
  • Obligatoriske parametere:
    • query: LogQL-spørringsstreng
  • Valgfrie parametere:
    • url: Loki-serverens URL (standard fra LOKI_URL env eller http://localhost:3100)
    • start: Starttid for spørringen (standard: 1 time siden)
    • end: Sluttid for spørringen (standard: nå)
    • limit: Maks antall poster som returneres (standard: 100)

Bruksområder for denne MCP-serveren

• Utforskning av loggdata
  Utviklere eller AI-agenter kan programmessig spørre og analysere loggdata lagret i Grafana Loki, og bistå med feilsøking og hendelseshåndtering.
• Automatisert loggovervåking
  Muliggjør LLM-drevne overvåkingsarbeidsflyter, hvor AI-assistenter kan skanne logger for avvik, feilmønstre eller spesifikke hendelser.
• Operasjonelle dashbord
  Legger til rette for dynamisk dashbordopprettelse ved å hente loggdata som trengs for visualiserings- eller rapporteringsverktøy.
• Rotårsaksanalyse
  Gjør AI i stand til å sile gjennom store mengder logger og finne opprinnelsen til problemer ved hjelp av fleksible LogQL-spørringer.

Slik setter du det opp

Windsurf

1. Installer Go 1.16 eller nyere.

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

3. Rediger Windsurf-konfigurasjonen for å legge til MCP-serveren.

4. Legg til Loki MCP-serveren med et JSON-utdrag (tilpass etter behov):

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

5. Lagre konfigurasjonen og start Windsurf på nytt.

6. Verifiser at serveren kjører og er tilgjengelig.

Sikring av API-nøkler (eksempel på miljøvariabler):

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

Claude

1. Installer Go 1.16 eller nyere.

2. Bygg serveren som over.

3. Åpne Claudes MCP-konfigurasjonsfil.

4. Legg til Loki MCP-serveren:

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

5. Lagre/start Claude på nytt.

6. Bekreft at oppsettet fungerer.

Sikring av API-nøkler:

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

Cursor

1. Sørg for at Go 1.16+ er installert.

2. Bygg Loki MCP-serveren.

3. Rediger Cursors konfigurasjon.

4. Legg til Loki MCP-serveroppføring:

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

5. Lagre og start Cursor på nytt.

6. Verifiser integrasjonen.

Bruke miljøvariabler:

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

Cline

1. Installer Go >=1.16.

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

3. Finn Clines MCP-serverkonfigurasjon.

4. Legg til Loki MCP-server:

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

5. Lagre og start Cline på nytt.

6. Test oppsettet.

Sikre API-nøkler via env:

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

Slik bruker du denne MCP-en i flows

Bruke MCP i FlowHunt

For å integrere MCP-servere i din FlowHunt-arbeidsflyt, start med å legge til MCP-komponenten i flowen og koble den til AI-agenten din:

Klikk på MCP-komponenten for å åpne konfigurasjonspanelet. I systemets MCP-konfigurasjonsseksjon, legg inn MCP-serverdetaljene dine med dette JSON-formatet:

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

Når dette er konfigurert, kan AI-agenten nå bruke denne MCP-en som et verktøy med tilgang til alle dens funksjoner og egenskaper. Husk å endre "loki-mcp" til det faktiske navnet på din MCP-server og bytte ut URL-en med din egen MCP-server-URL.

Oversikt

Basert på tabellen over tilbyr Loki MCP-serveren en tydelig oversikt og et funksjonelt verktøy for loggspørring, men mangler dokumenterte promptmaler, ressurser og avanserte MCP-funksjoner som sampling eller roots. Dokumentasjonen er minimal og oppsettet er utviklerorientert.

Vår vurdering

Loki MCP-serveren er fokusert og funksjonell for integrering av LLM-er med Grafana Loki-loggspørring, men den er minimalistisk og mangler bredde i MCP-funksjoner og dokumentasjon. For en vurdering ville den fått 4/10: den fungerer for sitt hovedformål, men er ikke en komplett, polert eller grundig dokumentert MCP-server.

MCP-score