Basit Loki MCP Sunucusu

“Basit Loki” MCP Sunucusu ne işe yarar?

Basit Loki MCP Sunucusu, AI asistanlarının bir Grafana Loki örneğinden doğrudan günlük sorgulama ve analiz yapmasını sağlayan bir Model Context Protokolü (MCP) arayüzüdür. logcli gibi araçları kullanarak veya gerekirse Loki HTTP API’ye başvurarak, bu sunucu günlük verilerinin geliştirme iş akışlarına sorunsuz entegrasyonunu sağlar. Tam LogQL sorgulamayı, etiket değeri almayı destekler ve birkaç çıktı seçeneğinde (varsayılan, ham, JSON satırları) biçimlendirilmiş sonuçlar sunar. Esnek kimlik doğrulama ve ortam değişkenleri veya yapılandırma dosyalarıyla yapılan ayarlarla Basit Loki MCP Sunucusu, gözlemlenebilirlik, sorun giderme ve izleme görevlerini AI destekli uygulamalarda veya otomasyon akışlarında geliştirmek için idealdir.

Prompt Listesi

Depoda veya belgelerde açık bir prompt şablonu belirtilmemiştir.

Kaynak Listesi

Depoda veya belgelerde açık bir MCP kaynağı listelenmemiştir.

Araç Listesi

• query-loki
  Loki’den günlükleri filtreleme seçenekleriyle sorgulayın. Bu araç, kullanıcıların LogQL sorguları göndermesine ve günlük kayıtlarını almasına olanak tanır; çeşitli çıktı formatlarını ve etiket meta verilerine erişimi destekler.

Bu MCP Sunucusunun Kullanım Alanları

• Günlük Analizi ve Sorun Giderme
  Geliştiriciler, Basit Loki MCP Sunucusu ile Grafana Loki’den günlük verilerini analiz edip filtreleyerek uygulama hatalarını ayıklamayı ve sorunları incelemeyi kolaylaştırabilir.
• Otomatik Olay Müdahalesi
  AI asistanları, olay akışlarında ilgili günlükleri otomatik olarak alıp özetleyerek müdahale süresini ve doğruluğunu artırabilir.
• Gözlemlenebilirlik Panoları
  Özel panolara günlük sorgulama yetenekleri entegre ederek, geliştirme veya izleme araçlarında gerçek zamanlı günlük içgörüleri elde edilebilir.
• Güvenlik İzleme
  AI ajanlarını günlüklerde şüpheli desenleri veya etkinlikleri izlemek için kullanın; anormallikler tespit edildiğinde uyarılar veya otomatik aksiyonlar tetiklenebilir.
• Performans Optimizasyonu
  Tarihsel günlük verilerini analiz ederek darboğazları, hataları veya sistemi etkileyen eğilimleri belirleyip proaktif optimizasyona yardımcı olun.

Kurulum Nasıl Yapılır

Windsurf

1. Node.js v16+ kurulu olduğundan emin olun.
2. Windsurf yapılandırma dosyanızı düzenleyin (örn. settings.json).
3. mcpServers bölümüne Basit Loki MCP Sunucusunu ekleyin:

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

4. Kaydedin ve Windsurf’u yeniden başlatın.
5. Günlük sorgulama yeteneklerini kontrol ederek sunucunun çalıştığını doğrulayın.

Claude

1. Node.js v16+ kurun.
2. Smithery ile sunucuyu yükleyin:

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

3. Claude yapılandırmanıza şunları ekleyin/güncelleyin:

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

4. Kaydedin ve Claude’u yeniden başlatın.
5. Loki günlük sorgulamanın kullanılabilir olduğunu onaylayın.

Cursor

1. Node.js v16+ kurulu olduğundan emin olun.
2. Cursor’ın yapılandırma dosyasını açın.
3. mcpServers altına şunu ekleyin:

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

4. Değişiklikleri kaydedin ve Cursor’u yeniden başlatın.
5. Günlük sorgulama işlevini test edin.

Cline

1. Node.js v16+ mevcut olduğundan emin olun.
2. Cline’ın yapılandırma dosyasını bulun ve açın.
3. Basit Loki MCP girdisini ekleyin:

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

4. Kaydedin ve Cline’ı yeniden başlatın.
5. Başarılı günlük sorgulama entegrasyonunu kontrol edin.

API Anahtarlarını Güvenceye Alma

Duyarlı kimlik bilgilerini (LOKI_ADDR veya token gibi) güvenlik için ortam değişkenlerinde saklayın. Örnek:

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

Bu MCP Nasıl Flowlarda Kullanılır

FlowHunt’ta MCP kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için önce MCP bileşenini akışınıza ekleyip AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümünde, MCP sunucu bilgilerinizi aşağıdaki JSON formatında girin:

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

Yapılandırıldıktan sonra, AI ajanı artık bu MCP’yi tüm işlev ve yeteneklerine erişebilecek bir araç olarak kullanabilir. “simple-loki” adını kendi MCP sunucu adınızla ve URL’yi kendi MCP sunucu URL’nizle değiştirmeyi unutmayın.

Genel Bakış

Yukarıdaki tablolara göre, Basit Loki MCP Sunucusu odaklı ve işlevsel olup, prompt ve kaynak desteği bakımından eksiktir. Kurulumu kolaydır ve entegrasyon ile API anahtarı güvenliği için net bir dokümantasyona sahiptir. Genel olarak günlük sorgulama için pratik, ancak gelişmiş MCP yeteneklerinde sınırlıdır.

MCP Puanı

Puan:
Bu MCP sunucusunu 6/10 olarak değerlendiriyorum. Amacına uygun, entegrasyonu kolay; ancak çoklu araç çeşitliliği, prompt şablonları ve geniş MCP kullanımına yönelik açık kaynak tanımları eksik. Roots veya Sampling desteğinden bahsedilmemiş.