MCP

Grafana MCP : d'abord lister les sources de données, ne pas tirer tout un grand tableau de bord

Pour qui a déjà Grafana 9.0+ et un jeton de compte de service, et veut voir sources ou tableaux de bord ; la première fois, lecture seule des sources — n'active pas runpanelquery.

Official source · grafana/mcp-grafana

Install

uvx mcp-grafana

À qui ça s'adresse

Pour qui a déjà une instance Grafana 9.0 ou plus récente et veut qu'un modèle voie l'instance et l'écosystème autour (tableaux de bord, sources). Les preuves indiquent : ce MCP donne accès à une instance Grafana et à l'écosystème autour.

Tu dois pouvoir fournir GRAFANA_URL et un jeton de compte de service GRAFANA_SERVICE_ACCOUNT_TOKEN. Sous 9.0, certaines fonctions (surtout liées aux sources) peuvent manquer faute d'API.

Les preuves ne listent pas les clients et n'écrivent pas la plupart des noms de fonctions d'outils. La première fois, lecture seule : n'active pas panel query (éteint par défaut), et n'utilise pas l'exemple localhost:3000 tel quel en production.

Premier essai en 3 minutes

Prends le chemin principal uvx. Dans le client, configure :

"command": "uvx",
"args": ["mcp-grafana"],
"env": {
  "GRAFANA_URL": "http://localhost:3000",
  "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}

Remplace l'URL par ton instance et le jeton par un token de compte de service. Ne les écris pas dans la conversation.

Prérequis : Grafana ≥ 9.0 joignable ; le compte de service a assez de droits pour lister les sources ou lire des tableaux de bord. Cet appel va vers ton Grafana avec le jeton ; ce n'est pas un bac à sable hors réseau.

Emplacement : command / args / env du MCP client.

Premier appel à faible risque : d'abord « lister et récupérer les informations de sources » (capacité des preuves). Ne tire pas d'abord un grand tableau de bord entier par UID. Les outils Run panel query sont éteints par défaut ; n'ajoute pas runpanelquery à --enabled-tools pour le premier essai.

Signal de succès : une fois le client connecté, tu vois la liste des sources configurées. En 401 ou sans connexion, vérifie d'abord URL et jeton, et si l'instance est ≥ 9.0.

Cas d'usage

Cas 1 : voir quelles sources l'instance a. Utilise « List and fetch datasource information ». Les preuves indiquent des types pris en charge dont Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena. Pas de noms de fonctions d'outils ni de filtres. Tu confirmes : les sources configurées et leurs détails.

Cas 2 : prendre le détail complet d'un tableau de bord par UID. Les preuves avertissent : un grand tableau de bord consomme beaucoup de fenêtre de contexte. Choisis un tableau dont tu connais l'UID et qui n'est pas énorme ; si le retour est trop long, arrête-toi à « les preuves ont déjà averti de la conso de contexte » — ne relance pas le tirage complet. Les preuves ne donnent pas le locator d'un outil de réduction JSONPath ; n'invente pas de nom de remplacement.

Limites d'usage

Il faut Grafana 9.0+, GRAFANA_URL et un jeton de compte de service. runpanelquery est désactivé par défaut et n'exécute panel query qu'une fois activé. Prendre tout un tableau par UID peut faire exploser le contexte. Types de sources : seulement ceux ci-dessus. Pas d'undo, pas de table complète de noms d'outils, pas de moindre privilège du jeton. Accéder à Grafana et aux sources n'est pas un risque zéro : ce que voit le compte de service, le modèle le voit. « Lister les sources en lecture seule » ne signifie ni « pas de réseau » ni « pas de noms de métriques sensibles ».