Serveur Loki MCP

Que fait le serveur “Loki” MCP ?

Le serveur Loki MCP est une implémentation Go du Model Context Protocol (MCP) conçue pour s’intégrer à Grafana Loki, un système d’agrégation de logs. Il sert de passerelle entre les assistants IA et les sources de données de logs externes, permettant à l’IA d’interroger et d’interagir avec les flux de logs stockés dans Loki. En exposant les capacités de requête de Loki via le protocole MCP, développeurs et clients IA peuvent enrichir leurs workflows — comme la recherche, le filtrage et l’analyse de logs — directement via des interfaces standardisées pilotées par LLM. Cela permet des tâches telles que l’investigation des logs en temps réel, le dépannage et la création de tableaux de bord, offrant un accès fluide aux données opérationnelles pour améliorer l’observabilité et l’automatisation.

Liste des prompts

Aucun modèle de prompt n’est documenté dans le dépôt.

Liste des ressources

Aucune ressource MCP explicite n’est décrite dans le dépôt.

Liste des outils

• loki_query
  Permet d’interroger les données de logs Grafana Loki.
  • Paramètres obligatoires :
    • query : chaîne LogQL de requête de logs
  • Paramètres optionnels :
    • url : URL du serveur Loki (défaut depuis la variable d’environnement LOKI_URL ou http://localhost:3100)
    • start : heure de début de la requête (défaut : il y a 1 heure)
    • end : heure de fin de la requête (défaut : maintenant)
    • limit : nombre maximal d’entrées à retourner (défaut : 100)

Cas d’usage de ce serveur MCP

• Exploration de données de logs
  Les développeurs ou agents IA peuvent interroger et analyser de manière programmatique les données de logs stockées dans Grafana Loki, facilitant le dépannage et la gestion des incidents.
• Surveillance automatisée des logs
  Permet des workflows de surveillance pilotés par LLM, où les assistants IA peuvent analyser les logs pour détecter des anomalies, des erreurs ou des événements particuliers.
• Tableaux de bord opérationnels
  Facilite la création dynamique de tableaux de bord en récupérant les données de logs nécessaires pour des outils de visualisation ou de reporting.
• Analyse des causes racines
  Permet à l’IA de parcourir de grands volumes de logs afin de localiser l’origine des problèmes à l’aide de requêtes LogQL flexibles.

Comment le configurer

Windsurf

1. Installez Go 1.16 ou supérieur.

2. Compilez le serveur :
   go build -o loki-mcp-server ./cmd/server

3. Modifiez la configuration Windsurf pour ajouter le serveur MCP.

4. Ajoutez le serveur Loki MCP via un extrait JSON (adaptez selon vos besoins) :

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

5. Sauvegardez la configuration et redémarrez Windsurf.

6. Vérifiez que le serveur fonctionne et est accessible.

Sécurisation des clés API (exemple avec variables d’environnement) :

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

Claude

1. Installez Go 1.16 ou supérieur.

2. Compilez le serveur comme ci-dessus.

3. Ouvrez le fichier de configuration MCP de Claude.

4. Ajoutez le serveur Loki MCP :

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

5. Sauvegardez/redémarrez Claude.

6. Vérifiez que la configuration fonctionne.

Sécurisation des clés API :

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

Cursor

1. Assurez-vous que Go 1.16+ est installé.

2. Compilez le serveur Loki MCP.

3. Modifiez la configuration de Cursor.

4. Ajoutez l’entrée du serveur Loki MCP :

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

5. Sauvegardez et redémarrez Cursor.

6. Vérifiez l’intégration.

Utilisation des variables d’environnement :

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

Cline

1. Installez Go >=1.16.

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

3. Localisez la configuration serveur MCP de Cline.

4. Ajoutez le serveur Loki MCP :

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

5. Sauvegardez et redémarrez Cline.

6. Testez la configuration.

Sécurisez les clés API via env :

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

Comment utiliser ce MCP dans les flux

Utilisation du MCP dans FlowHunt

Pour intégrer des serveurs MCP dans votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flux et connectez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section de configuration système MCP, insérez les détails de votre serveur MCP au format JSON suivant :

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

Une fois la configuration faite, l’agent IA pourra utiliser ce MCP comme outil avec l’accès à toutes ses fonctions et capacités. N’oubliez pas de remplacer "loki-mcp" par le nom réel de votre serveur MCP et l’URL par celle de votre serveur MCP.

Vue d’ensemble

D’après les tableaux ci-dessus, le serveur Loki MCP offre une vue d’ensemble claire et un outil fonctionnel pour interroger les logs, mais il manque de prompts documentés, de ressources et de fonctionnalités MCP avancées comme l’échantillonnage ou les roots. La documentation est minimale et la configuration s’adresse principalement aux développeurs.

Notre avis

Le serveur Loki MCP est ciblé et fonctionnel pour intégrer les LLMs avec l’interrogation de logs Grafana Loki, mais il reste minimaliste et manque d’étendue dans les fonctionnalités MCP et la documentation. Pour la note, il obtiendrait 4/10 : il fonctionne pour son objectif principal, mais n’est pas un serveur MCP complet, abouti ou très documenté.

Score MCP