Loki MCP -palvelin

Mitä “Loki” MCP -palvelin tekee?

Loki MCP -palvelin on Go-pohjainen Model Context Protocolin (MCP) toteutus, joka integroituu Grafana Lokiin - lokien keräysjärjestelmään. Se toimii sillanrakentajana AI-avustajien ja ulkoisten lokitietolähteiden välillä mahdollistaen AI:n kysellä ja käsitellä Lokiin tallennettuja lokivirtoja. Tuomalla Lokin kyselyominaisuudet MCP-protokollan kautta kehittäjät ja AI-asiakkaat voivat laajentaa työnkulkujaan – kuten etsiä, suodattaa ja analysoida lokeja – suoraan standardisoitujen LLM-ohjattujen rajapintojen avulla. Tämä mahdollistaa esimerkiksi reaaliaikaisen lokitutkinnan, vianetsinnän ja koontinäyttöjen luonnin, tarjoten sujuvan pääsyn operatiivisiin tietoihin havainnointia ja automaatiota varten.

Kyselypohjien lista

Yhtään prompt-pohjaa ei ole dokumentoitu repositoriossa.

Resurssien lista

Yhtään eksplisiittistä MCP-resurssia ei ole kuvattu repositoriossa.

Työkalujen lista

• loki_query
  Mahdollistaa Grafana Loki -lokitietojen kyselyn.
  • Pakolliset parametrit:
    • query: LogQL-kyselymerkkijono
  • Valinnaiset parametrit:
    • url: Loki-palvelimen URL (oletus LOKI_URL-ympäristömuuttujasta tai http://localhost:3100)
    • start: Kyselyn aloitusaika (oletus: 1 tunti sitten)
    • end: Kyselyn lopetusaika (oletus: nyt)
    • limit: Palautettavien merkintöjen enimmäismäärä (oletus: 100)

Tämän MCP-palvelimen käyttötapaukset

• Lokitietojen tutkiminen
  Kehittäjät tai AI-agentit voivat ohjelmallisesti kysellä ja analysoida Grafana Lokiin tallennettuja lokitietoja, mikä auttaa vianetsinnässä ja tapahtumiin reagoinnissa.
• Automaattinen lokivalvonta
  Mahdollistaa LLM-ohjatut valvontatyönkulut, joissa AI-avustajat voivat tarkastella lokeja poikkeamien, virhekuvioiden tai tiettyjen tapahtumien varalta.
• Operatiiviset koontinäytöt
  Helpottaa dynaamisten koontinäyttöjen luontia hakemalla visualisointi- tai raportointityökaluihin tarvittavan lokitiedon.
• Juurisyyanalyysi
  Mahdollistaa AI:n seulomaan suuria lokimääriä ja paikantamaan ongelmien alkuperän joustavilla LogQL-kyselyillä.

Näin otat palvelimen käyttöön

Windsurf

1. Asenna Go 1.16 tai uudempi.

2. Käännä palvelin:
   go build -o loki-mcp-server ./cmd/server

3. Muokkaa Windsurf-asetuksiasi lisätäksesi MCP-palvelimen.

4. Lisää Loki MCP -palvelin JSON-pätkällä (muokkaa tarvittaessa):

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

5. Tallenna asetukset ja käynnistä Windsurf uudelleen.

6. Varmista, että palvelin on käynnissä ja saavutettavissa.

API-avainten suojaaminen (ympäristömuuttujaesimerkki):

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

Claude

1. Asenna Go 1.16 tai uudempi.

2. Käännä palvelin kuten yllä.

3. Avaa Clauden MCP-asetustiedosto.

4. Lisää Loki MCP -palvelin:

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

5. Tallenna/käynnistä Claude uudelleen.

6. Varmista, että asennus toimii.

API-avainten suojaaminen:

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

Cursor

1. Varmista, että Go 1.16+ on asennettu.

2. Käännä Loki MCP -palvelin.

3. Muokkaa Cursorin asetuksia.

4. Lisää Loki MCP -palvelin:

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

5. Tallenna ja käynnistä Cursor uudelleen.

6. Varmista integraatio.

Ympäristömuuttujien käyttö:

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

Cline

1. Asenna Go >=1.16.

2. Käännä:
   go build -o loki-mcp-server ./cmd/server

3. Etsi Clinen MCP-palvelinasetukset.

4. Lisää Loki MCP -palvelin:

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

5. Tallenna ja käynnistä Cline uudelleen.

6. Testaa asennus.

API-avainten suojaus ympäristömuuttujilla:

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

Näin käytät tätä MCP:tä työnkuluissa

MCP:n käyttö FlowHuntissa

Voit integroida MCP-palvelimet FlowHunt-työnkulkuusi lisäämällä MCP-komponentin työnkulkuun ja liittämällä sen AI-agenttiin:

Klikkaa MCP-komponenttia avataksesi asetuspaneelin. Järjestelmän MCP-asetusten osioon lisätään MCP-palvelimen tiedot seuraavassa JSON-muodossa:

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

Kun asetukset on määritetty, AI-agentti voi käyttää tätä MCP:tä työkaluna kaikkien sen toimintojen ja ominaisuuksien kanssa. Muista muuttaa "loki-mcp" MCP-palvelimesi todelliseksi nimeksi ja korvata URL omalla MCP-palvelimesi osoitteella.

Yhteenveto

Edellä olevan taulukon perusteella Loki MCP -palvelin tarjoaa selkeän yleiskuvan ja toimivan työkalun lokien kyselyyn, mutta siltä puuttuu dokumentoidut kyselypohjat, resurssit sekä kehittyneet MCP-ominaisuudet kuten näytteenotto tai roots. Dokumentaatio on minimaalinen ja asennus on suunnattu kehittäjille.

Mielipiteemme

Loki MCP -palvelin on keskittynyt ja toimiva ratkaisu LLM:ien ja Grafana Loki -kyselyjen yhdistämiseen, mutta se on pelkistetty ja siltä puuttuu MCP-ominaisuuksien ja dokumentaation laajuus. Arvosanaksi annamme 4/10: se täyttää päätehtävänsä, mutta ei ole ominaisuuksiltaan kattava, viimeistelty tai hyvin dokumentoitu MCP-palvelin.

MCP-pisteet