Crea y administra dashboards de Grafana y alertas preconfiguradas para servicios e infraestructura habituales, sin tener que escribir consultas a mano.
23820JinjaGPL-3.0Actualizado hace 11 meses
grafana/mcp-grafana
Un servidor MCP que permite a los asistentes de IA acceder a dashboards, fuentes de datos, alertas, incidentes y más de Grafana.
- Estrellas
- 3,592
- Forks
- 474
- Issues abiertos
- 84
- Último commit
- hace 7 horas
¿Qué es?
mcp-grafana es un servidor Model Context Protocol escrito en Go que conecta clientes compatibles con MCP, como Claude Desktop y Cursor, con una instancia de Grafana. Tras configurarlo con una URL de Grafana y un token de cuenta de servicio, un asistente puede buscar y leer dashboards, ejecutar consultas de paneles y consultar fuentes de datos conectadas, como Prometheus, Loki, ClickHouse, Elasticsearch y CloudWatch.
Además de dashboards y métricas, el servidor ofrece herramientas para reglas de alertas y puntos de contacto, horarios y grupos de alertas de Grafana OnCall, Grafana Incident, anotaciones, snapshots, generación de deeplinks y renderizado de imágenes de dashboards. Las categorías de herramientas se pueden habilitar o deshabilitar con flags; las que acceden a áreas sensibles, como admin, SQL o InfluxDB, están deshabilitadas de forma predeterminada. El acceso se rige por los permisos de Grafana RBAC otorgados a la cuenta de servicio.
El servidor se ejecuta mediante uvx, Docker, un binario independiente o un chart de Helm, y requiere Grafana 9.0 o posterior para ofrecer toda la funcionalidad.
Funciones clave
- 01Buscar, leer y actualizar dashboards de Grafana, incluida la extracción y modificación de propiedades mediante JSONPath.
- 02Consultar fuentes de datos de Prometheus, Loki, InfluxDB, Elasticsearch, CloudWatch y SQL mediante herramientas MCP.
- 03Administrar reglas de alertas, políticas de notificación y puntos de contacto.
- 04Leer y administrar horarios y grupos de alertas de Grafana OnCall.
- 05Renderizar paneles de dashboards como imágenes PNG mediante Grafana Image Renderer.
- 06Habilitar o deshabilitar categorías de herramientas con flags de línea de comandos.
Casos de uso
- Permitir que un asistente de IA investigue un incidente de producción consultando métricas y logs en Grafana.
- Generar o editar dashboards a partir de solicitudes en lenguaje natural y mantener bajo el uso de contexto.
- Auditar reglas de alertas y horarios de guardia mediante una interfaz de chat.
- Generar imágenes de dashboards para informes o notificaciones de chat.
Inicio rápido
- 1
Instala uv (necesario para uvx)
- 2
Añade el servidor MCP de Grafana a la configuración de tu cliente MCP con tu GRAFANA_URL y el token de la cuenta de servicio
- 3
Ejecuta el servidor con uvx
uvx mcp-grafana
Antes de usarlo
- Para disponer de toda la funcionalidad se requiere Grafana 9.0 o posterior; algunas funciones de las fuentes de datos pueden fallar en versiones anteriores.
- Muchas herramientas, como ejecutar consultas de panel, SQL, CloudWatch e InfluxDB, están desactivadas de forma predeterminada y deben activarse con --enabled-tools.
En colecciones
Temas
Preguntas frecuentes
- ¿Qué es mcp-grafana?
- Un servidor MCP que permite a los asistentes de IA acceder a dashboards, fuentes de datos, alertas, incidentes y más de Grafana. mcp-grafana es un servidor Model Context Protocol escrito en Go que conecta clientes compatibles con MCP, como Claude Desktop y Cursor, con una instancia de Grafana. Tras configurarlo con una URL de Grafana y un token de cuenta de servicio, un asistente puede buscar y leer dashboards, ejecutar consultas de paneles y consultar fuentes de datos conectadas, como Prometheus, Loki, ClickHouse, Elasticsearch y CloudWatch.
- ¿mcp-grafana es gratuito? ¿Qué licencia tiene?
- mcp-grafana es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿mcp-grafana sigue mantenido?
- Mantenimiento activo. El último commit de mcp-grafana fue el 22 oct 2026.
- ¿Para qué puedo usar mcp-grafana?
- Permitir que un asistente de IA investigue un incidente de producción consultando métricas y logs en Grafana. Generar o editar dashboards a partir de solicitudes en lenguaje natural y mantener bajo el uso de contexto. Auditar reglas de alertas y horarios de guardia mediante una interfaz de chat. Generar imágenes de dashboards para informes o notificaciones de chat.
- ¿Cómo se instala mcp-grafana?
- Instala uv (necesario para uvx) Añade el servidor MCP de Grafana a la configuración de tu cliente MCP con tu GRAFANA_URL y el token de la cuenta de servicio Ejecuta el servidor con uvx: uvx mcp-grafana
- ¿Dónde consigo mcp-grafana?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/grafana/mcp-grafana
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Agente de código abierto para monitorear infraestructura en tiempo real, con métricas por segundo, detección automática, detección de anomalías con ML y alertas integradas.
81,1 mil6,7 milGoGPL-3.0Actualizado hace 2 horas
Plataforma de código abierto para consultar, visualizar, explorar y configurar alertas sobre métricas, registros y trazas de múltiples fuentes de datos.
77,4 mil14,8 milTypeScriptAGPL-3.0Actualizado hace 2 horas
Prometheus es un sistema de código abierto para monitorear sistemas y servicios, recopilar métricas, evaluar reglas y activar alertas.
66,7 mil10,9 milGoApache-2.0Actualizado hace 4 horas
Monitoreo ligero de servidores autoalojado, con panel web, métricas de contenedores Docker, datos históricos y alertas.
26,4 mil1,1 milGoMITActualizado hace 4 horas
Alertas autohospedadas para métricas, logs y fuentes de datos SQL, con enrutamiento de notificaciones y un agente de IA y servidor MCP integrados.
13,4 mil1,8 milGoApache-2.0Actualizado hace 12 horas