mcp-grafana

El servidor MCP de Grafana es un servidor de Model Context Protocol (MCP) que conecta clientes MCP como Claude Desktop o Cursor a una instancia de Grafana y su ecosistema. Requiere Grafana 9.0 o posterior para su funcionalidad completa, ya que algunas operaciones de fuentes de datos dependen de endpoints de API más recientes. La configuración se realiza añadiendo una entrada a la configuración del cliente MCP, normalmente ejecutando el servidor mediante uvx con GRAFANA_URL y un token de cuenta de servicio en el entorno. También se documentan opciones de instalación con Docker, binario y Helm. Las capacidades se agrupan en categorías de herramientas, y la lista de herramientas es configurable, de modo que la funcionalidad no utilizada puede desactivarse para ahorrar espacio en la ventana de contexto. Las categorías pueden desactivarse con flags como --disable-oncall o --disable-navigation, y varias categorías están desactivadas por defecto y deben habilitarse explícitamente mediante --enabled-tools. Las herramientas de paneles abarcan la búsqueda por título, UID de carpeta, etiqueta o estado destacado; la obtención de un panel por UID o por una versión guardada; el listado de versiones; la obtención de un resumen compacto; la extracción de partes mediante JSONPath; la creación, actualización y aplicación de parches a paneles; y la lectura de consultas de paneles con información de la fuente de datos. El README señala que el JSON completo de un panel puede consumir una cantidad significativa de espacio en la ventana de contexto y sugiere usar en su lugar las herramientas de resumen o JSONPath. La compatibilidad con fuentes de datos y consultas incluye el listado e inspección de fuentes de datos (Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena), consultas instantáneas y de rango de PromQL, además de metadatos de métricas y percentiles de histogramas, consultas de logs y métricas de LogQL con descubrimiento de etiquetas y patrones, InfluxDB mediante InfluxQL o Flux, herramientas SQL unificadas para ClickHouse, Snowflake, Athena, MySQL, PostgreSQL y MSSQL con sustitución de macros y aplicación de límites, espacios de nombres, métricas y dimensiones de CloudWatch, consultas de renderizado de Graphite y descubrimiento de métricas, búsqueda en Elasticsearch/OpenSearch y Quickwit, y recuperación de consultas de ejemplo. Las consultas SQL se ejecutan a través de los plugins de fuentes de datos de Grafana, por lo que las credenciales se gestionan mediante la configuración de la fuente de datos y no por el servidor MCP. Las áreas operativas incluyen alertas (listar, crear, actualizar y eliminar reglas; políticas de notificación, puntos de contacto, intervalos de tiempo), Grafana Incident (buscar, crear, actualizar, campos personalizados), investigaciones de Sift (listado, detalle, análisis, detección de patrones de error y solicitudes lentas), Grafana OnCall (horarios, turnos, usuarios actualmente de guardia, equipos, usuarios, grupos de alertas), anotaciones (consultar, crear, actualizar, aplicar parches, eliminar, etiquetas), snapshots (listar, obtener, crear, eliminar), renderizado de paneles o dashboards como PNG mediante Grafana Image Renderer, listado del repositorio de aprovisionamiento y validación en seco, generación de deeplinks para paneles, paneles individuales y Explore, y búsqueda de identidad de usuario para solicitudes multi-organización. Las herramientas de Agent Observability, exclusivas de Grafana Cloud, abarcan el listado y la búsqueda de conversaciones de LLM, el detalle de conversaciones y generaciones con puntuaciones de evaluación, un catálogo de agentes con historial de versiones y estimaciones de tokens, evaluadores y plantillas, reglas y guardas de evaluación, conversaciones y colecciones guardadas, suites de pruebas y experimentos offline. Algunas de ellas incluyen operaciones de escritura restringidas por un permiso específico. Las herramientas de Grafana Assistant envían prompts en lenguaje natural al asistente y permiten continuar una conversación mediante un ID de contexto devuelto; son herramientas de escritura y se omiten cuando se establece --disable-write. El control de acceso está basado en RBAC: cada herramienta necesita permisos y ámbitos concretos, y el README recomienda crear una cuenta de servicio con los permisos necesarios, señalando que el rol integrado Editor es una alternativa más sencilla pero menos granular. Las herramientas de Incident y Sift usan roles básicos de Viewer/Editor en lugar de permisos detallados. El README incluye una tabla de herramientas que asigna los nombres de las herramientas a categorías, permisos RBAC requeridos y ámbitos requeridos.