Repolode
Enviar
grafana

grafana/mcp-grafana

Um servidor MCP que dá a assistentes de IA acesso a dashboards, fontes de dados, alertas, incidentes e muito mais no Grafana.

Ver no GitHub
Estrelas
3,592
Forks
474
Issues abertas
84
Último commit
há 7 horas

O que é?

mcp-grafana é um servidor Model Context Protocol escrito em Go que conecta clientes compatíveis com MCP, como Claude Desktop e Cursor, a uma instância do Grafana. Depois de configurado com uma URL do Grafana e um token de conta de serviço, um assistente pode pesquisar e ler dashboards, executar consultas de painéis e consultar fontes de dados conectadas, como Prometheus, Loki, ClickHouse, Elasticsearch e CloudWatch.

Além de dashboards e métricas, o servidor disponibiliza ferramentas para regras de alerta e pontos de contato, agendas e grupos de alertas do Grafana OnCall, Grafana Incident, anotações, snapshots, geração de deeplinks e renderização de imagens de dashboards. As categorias de ferramentas podem ser ativadas ou desativadas com flags, e as ferramentas que acessam áreas sensíveis, como admin, SQL ou InfluxDB, vêm desativadas por padrão. O acesso é controlado pelas permissões RBAC do Grafana concedidas à conta de serviço.

O servidor pode ser executado por meio de uvx, Docker, um binário independente ou um chart Helm, e requer o Grafana 9.0 ou posterior para oferecer todas as funcionalidades.

Recursos principais

  • 01Pesquisar, ler e atualizar dashboards do Grafana, incluindo extração e aplicação de patches em propriedades com JSONPath.
  • 02Consultar fontes de dados Prometheus, Loki, InfluxDB, Elasticsearch, CloudWatch e SQL por meio de ferramentas MCP.
  • 03Gerenciar regras de alerta, políticas de notificação e pontos de contato.
  • 04Ler e gerenciar agendas e grupos de alertas do Grafana OnCall.
  • 05Renderizar painéis de dashboards como imagens PNG usando o Grafana Image Renderer.
  • 06Ativar ou desativar categorias de ferramentas com flags de linha de comando.

Casos de uso

  • Permitir que um assistente de IA investigue um incidente em produção consultando métricas e logs no Grafana.
  • Gerar ou editar dashboards a partir de solicitações em linguagem natural, mantendo baixo o uso de contexto.
  • Auditar regras de alerta e agendas de plantão por meio de uma interface de chat.
  • Gerar imagens de dashboards para relatórios ou notificações em chats.

Início rápido

  1. 1

    Instale o uv (necessário para o uvx)

  2. 2

    Adicione o servidor MCP do Grafana à configuração do seu cliente MCP com seu GRAFANA_URL e o token da conta de serviço

  3. 3

    Execute o servidor com o uvx

    uvx mcp-grafana

Antes de usar

  • A funcionalidade completa requer o Grafana 9.0 ou posterior, e alguns recursos de fontes de dados podem falhar em versões anteriores.
  • Muitas ferramentas, como executar consultas de painel, SQL, CloudWatch e InfluxDB, ficam desativadas por padrão e precisam ser ativadas com --enabled-tools.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPPlataformas de OpenTelemetry e observabilidade

Tópicos

#mcp#grafana#observability#monitoring#ai-agent#go#alerting

Perguntas frequentes

O que é mcp-grafana?
Um servidor MCP que dá a assistentes de IA acesso a dashboards, fontes de dados, alertas, incidentes e muito mais no Grafana. mcp-grafana é um servidor Model Context Protocol escrito em Go que conecta clientes compatíveis com MCP, como Claude Desktop e Cursor, a uma instância do Grafana. Depois de configurado com uma URL do Grafana e um token de conta de serviço, um assistente pode pesquisar e ler dashboards, executar consultas de painéis e consultar fontes de dados conectadas, como Prometheus, Loki, ClickHouse, Elasticsearch e CloudWatch.
mcp-grafana é gratuito? Qual é a licença?
mcp-grafana é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-grafana ainda é mantido?
Manutenção ativa. O último commit de mcp-grafana foi em 22 de out. de 2026.
Para que posso usar mcp-grafana?
Permitir que um assistente de IA investigue um incidente em produção consultando métricas e logs no Grafana. Gerar ou editar dashboards a partir de solicitações em linguagem natural, mantendo baixo o uso de contexto. Auditar regras de alerta e agendas de plantão por meio de uma interface de chat. Gerar imagens de dashboards para relatórios ou notificações em chats.
Como instalar mcp-grafana?
Instale o uv (necessário para o uvx) Adicione o servidor MCP do Grafana à configuração do seu cliente MCP com seu GRAFANA_URL e o token da conta de serviço Execute o servidor com o uvx: uvx mcp-grafana
Onde consigo mcp-grafana?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/grafana/mcp-grafana

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados