Skip to main content
Glama
Zabbix MCP Server Universal

Zabbix MCP Server Universal

by nks1097

Zabbix MCP Server Universal

License: MIT Python Version MCP Protocol Zabbix

Servidor MCP (Model Context Protocol) corporativo para gerenciamento inteligente do Zabbix Enterprise Monitoring, com 100 ferramentas em português, automação completa de descoberta e onboarding de dispositivos em 6 estágios, motor profissional de relatórios (PDF, XLSX, CSV, JSON, Markdown), controles de acesso baseados em funções (RBAC), aprovação em dois passos e compatibilidade universal.

Read this in English: README.en.md


🚀 Destaques do Projeto

  • 100 Ferramentas Oficiais: Nomes estáveis em snake_case, contratos Pydantic estritos e descrições detalhadas em português cobrindo todas as áreas operacionais do Zabbix.

  • Onboarding Automatizado de Dispositivos (Estágios A ao F):

    1. Descoberta Controlada: Varredura de sub-redes autorizadas com taxa limitada e sem risco de saturação.

    2. Identificação & Fingerprinting: Inferência de Sistema Operacional (Linux, Windows, Network Appliance) com score de confiança e portas de serviço.

    3. Reconciliação & Deduplicação: Checagem contra o inventário existente para evitar hosts duplicados.

    4. Planejamento & Prévia: Exibição de interfaces, grupos e templates antes de qualquer gravação.

    5. Cadastro em Lote Transacional: Criação segura com tratamento individual de falhas.

    6. Verificação Pós-Cadastro: Confirmação de interfaces sem erros, itens ativos e chegada do primeiro ciclo de métricas.

  • Motor Profissional de Relatórios: Geração direta de documentos em PDF corporativo (com tabelas e layout executivo), Planilhas Excel (.xlsx) multi-abas, CSV, JSON e Markdown.

  • Segurança Produtiva (DevSecOps):

    • Modos de autorização RBAC: somente_leitura (padrão), operacional e administrativo.

    • Aprovação em Dois Passos: Ações destrutivas (excluir hosts, alterar regras) exigem token criptográfico HMAC vinculado aos parâmetros exatos com expiração de 15 minutos.

    • Redação Automática de Segredos: Tokens, senhas e communities SNMP são mascarados como [REDACTED].

    • Proteção contra SSRF: Bloqueio de loopback (127.0.0.1) e limitação de escopos de varredura.

    • Trilha de Auditoria Local: Registro imutável em JSON Lines (audit_mcp.jsonl) de todas as invocações.

  • Compatibilidade Inteligente de Versões: Identificação dinâmica via apiinfo.version com suporte a autenticação por cabeçalho Bearer no Zabbix 7.0+ e suporte a Zabbix 6.0 LTS / 6.4.


Related MCP server: Zabbix MCP Server

📖 Guia de Instalação e Configuração Passo a Passo

Passo 1: Pré-Requisitos do Sistema

  • Python: Versão 3.11, 3.12 ou 3.13 instalada (python --version ou python3 --version).

  • Git: Instalado no sistema (git --version).

  • Instância Zabbix: Endpoint HTTP/HTTPS acessível (ex: http://192.168.0.107:8080/api_jsonrpc.php).


Passo 2: Gerar o Token de API no Zabbix Web

O token de API é o método mais seguro e recomendado de autenticação:

  1. Abra a interface web do Zabbix no navegador.

  2. Acesse o menu: Administração (Administration) ➔ Tokens de API (API tokens).

  3. Clique em Criar token de API (Create API token) no canto superior direito.

  4. Digite um nome (ex: Zabbix-MCP-Server) e clique em Adicionar (Add).

  5. Copie imediatamente a chave de 64 caracteres exibida na janela pop-up (ela não será mostrada novamente).


Passo 3: Clonar o Repositório do GitHub

git clone https://github.com/nks1097/zabbix-mcp-server.git
cd zabbix-mcp-server

Passo 4: Criar e Ativar o Ambiente Virtual

No Windows (PowerShell):

TIP

Caso o PowerShell bloqueie a execução de scripts (running scripts is disabled on this system), execute o comando abaixo antes de ativar:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
python -m venv .venv
.\.venv\Scripts\activate

(O indicador (.venv) aparecerá no início da sua linha de comando).

No Linux / macOS:

python3 -m venv .venv
source .venv/bin/activate

Passo 5: Instalar as Dependências do Projeto

pip install --upgrade pip
pip install -e ".[dev]"

Passo 6: Configurar o Arquivo .env

Copie o arquivo de exemplo .env.example criando o seu .env:

No Windows:

copy .env.example .env

No Linux / macOS:

cp .env.example .env

Edite o arquivo .env com os dados do seu Zabbix:

# URL completa do endpoint JSON-RPC do Zabbix
ZABBIX_URL=http://SEU_IP:8080/api_jsonrpc.php

# Token de API do Zabbix gerado no Passo 2
ZABBIX_TOKEN=SEU_TOKEN

# Modo de operação: 'somente_leitura', 'operacional' ou 'administrativo'
ZABBIX_MCP_MODE=operacional

# Validação SSL (defina false para certificados autoassinados ou HTTP local)
ZABBIX_VERIFY_SSL=false

# Exigir aprovação em 2 passos para ações destrutivas (excluir hosts)
ZABBIX_REQUIRE_APPROVAL_DESTRUCTIVE=true
ZABBIX_APPROVAL_TOKEN_SECRET=sua-chave-secreta-hmac-aqui

Passo 7: Validar a Instalação com Testes

Execute a suíte de testes automatizados para validar a integridade:

# Executar todos os testes unitários (offline com fixtures mock)
pytest tests/unit -v

# Executar os testes de integração ao vivo contra a sua instância do Zabbix
pytest tests/integration/test_live_zabbix.py -v

🔌 Configuração nos Principais Clientes MCP

1. Claude Desktop

Adicione ao arquivo de configuração:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zabbix": {
      "command": "C://SEU_CAMINHO//zabbix-mcp-server//.venv//Scripts//python.exe",
      "args": ["-m", "zabbix_mcp.server", "--transport", "stdio"],
      "cwd": "C://SEU_CAMINHO//zabbix-mcp-server",
      "env": {
        "ZABBIX_URL": "http://SEU_IP:8080/api_jsonrpc.php",
        "ZABBIX_TOKEN": "seu_token_aqui",
        "ZABBIX_MCP_MODE": "operacional",
        "ZABBIX_VERIFY_SSL": "false"
      }
    }
  }
}

2. Antigravity IDE (mcp_config.json)

Localizado em ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "zabbix-mcp": {
      "command": "C:\\SEU_CAMINHO\\zabbix-mcp-server\\.venv\\Scripts\\python.exe",
      "args": [
        "-m",
        "zabbix_mcp.server",
        "--transport",
        "stdio"
      ],
      "cwd": "C:\\SEU_CAMINHO\\zabbix-mcp-server",
      "env": {
        "ZABBIX_URL": "http://SEU_IP:8080/api_jsonrpc.php",
        "ZABBIX_TOKEN": "seu_token_aqui",
        "ZABBIX_MCP_MODE": "operacional"
      }
    }
  }
}

3. Cursor (.cursor/mcp.json)

No arquivo .cursor/mcp.json na raiz do workspace ou nas configurações de MCP:

{
  "mcpServers": {
    "zabbix": {
      "command": "python",
      "args": ["-m", "zabbix_mcp.server", "--transport", "stdio"],
      "env": {
        "ZABBIX_URL": "http://SEU_IP:8080/api_jsonrpc.php",
        "ZABBIX_TOKEN": "seu_token_aqui",
        "ZABBIX_MCP_MODE": "operacional"
      }
    }
  }
}

4. VS Code (com Cline / Roo Code / Claude Dev)

Nas configurações da extensão ou no arquivo de ferramentas MCP:

{
  "mcpServers": {
    "zabbix": {
      "command": "python",
      "args": ["-m", "zabbix_mcp.server", "--transport", "stdio"],
      "env": {
        "ZABBIX_URL": "http://SEU_IP:8080/api_jsonrpc.php",
        "ZABBIX_TOKEN": "seu_token_aqui",
        "ZABBIX_MCP_MODE": "operacional"
      }
    }
  }
}

VIDEO DE CONFIGURAÇÃO DE FORMA SIMPLIFICADA

▶️ Clique aqui para assistir ao vídeo completo no Google Drive Assiste em Full Hd (1080P)

🐳 Execução via Docker e Docker Compose

Para rodar o servidor MCP como um microsserviço containerizado com transporte SSE:

# 1. Copiar e preencher o .env
cp .env.example .env

# 2. Inicializar o container em segundo plano
docker compose up -d

# 3. Verificar os logs
docker compose logs -f zabbix-mcp

# 4. Validar o endpoint SSE
curl -I http://localhost:8000/sse

🔒 Modos de Segurança e Permissões (RBAC)

O servidor implementa 3 níveis de permissão controlados pela variável ZABBIX_MCP_MODE:

  1. somente_leitura (Padrão de Fábrica): Bloqueia qualquer operação que tente alterar dados no Zabbix. Apenas consultas e relatórios são permitidos.

  2. operacional: Permite criação e atualização de hosts, reconhecimento de problemas, manutenções e vinculação de templates.

  3. administrativo: Habilita comandos estruturais críticos. Ações destrutivas (excluir hosts, remover proxies) exigem aprovação em dois passos via token HMAC.


🛠️ Catálogo Completo das 100 Ferramentas (Para que serve cada uma)

Abaixo está o índice descritivo de todas as 100 ferramentas disponíveis no servidor MCP, organizadas por suas 10 categorias funcionais. Para especificações detalhadas de todos os parâmetros e esquemas JSON de entrada/saída, consulte o Manual Técnico de Ferramentas.

Categoria 1 — Descoberta Automática de Dispositivos

#

Ferramenta

Nível

Para que serve

01

zabbix_descobrir_rede

Operacional

Realiza uma varredura controlada e não-intrusiva em faixas de rede CIDR IPv4 explicitamente autorizadas.

02

zabbix_analisar_dispositivo

Somente Leitura

Analisa detalhadamente um endereço IP específico, coletando latência, hostname reverso via DNS (PTR), portas abertas fundamentais (22/SSH, 80/HTTP, 443/HTTPS, 161/SNMP, 10050/Agent, 3389/RDP, 445/SMB) e evidências preliminares de identificação.

03

zabbix_identificar_sistema_operacional

Somente Leitura

Infere o sistema operacional provável (Linux, Windows Server, Appliance de Rede, Servidor Web) a partir de assinaturas de portas e comportamento de rede, retornando o nome do SO e um percentual de confiança.

04

zabbix_identificar_servicos

Somente Leitura

Mapeia serviços monitoráveis em execução no host (servidores HTTP/Nginx/Apache, bancos de dados MySQL/PostgreSQL, SSH, Docker, SNMP) através de sondagens não-invasivas em portas bem conhecidas.

05

zabbix_deduplicar_dispositivos

Somente Leitura

Verifica se um dispositivo descoberto já se encontra cadastrado no Zabbix Server, comparando endereços IP de interfaces, nomes visíveis, nomes técnicos e resolução DNS.

06

zabbix_comparar_dispositivos_cadastrados

Somente Leitura

Cruza uma lista de IPs descobertos com todos os hosts atualmente cadastrados no Zabbix, gerando um balanço categorizado: novos nós a cadastrar, nós já monitorados e possíveis divergências de configuração.

07

zabbix_recomendar_templates

Somente Leitura

Cruza o sistema operacional e serviços detectados com o acervo de templates instalados no Zabbix, recomendando os templates oficiais mais indicados com seus respectivos IDs.

08

zabbix_previsualizar_cadastro

Somente Leitura

Simula a criação do host no Zabbix (Dry-Run), apresentando a estrutura JSON exata dos parâmetros: nome técnico, nome visível, interfaces, grupos, templates vinculados e macros, sem gravar alterações.

09

zabbix_cadastrar_dispositivos_em_lote

Operacional

Cria múltiplos hosts aprovados no Zabbix de forma transacional e segura.

10

zabbix_verificar_descoberta

Somente Leitura

Audita o estado pós-implantação dos hosts criados: confirma se a interface está ativa, se os templates foram herdados, se os itens estão criados e se os primeiros dados de telemetria já chegaram.

Categoria 2 — Hosts e Interfaces

#

Ferramenta

Nível

Para que serve

11

zabbix_listar_hosts

Somente Leitura

Lista os hosts monitorados no Zabbix aplicando filtros flexíveis por nome, grupo de hosts, status de monitoramento (habilitado/desabilitado) e estado de disponibilidade de interface.

12

zabbix_consultar_host

Somente Leitura

Retorna o registro completo e detalhado de um host específico no Zabbix, incluindo interfaces de rede, grupos vinculados, templates herdados, macros, status e metadados de inventário.

13

zabbix_criar_host

Operacional

Cria um novo host no Zabbix com parâmetros estritamente validados: nome técnico, nome visível, endereço IP ou DNS, porta, tipo de interface (Agent, SNMP, IPMI, JMX), grupos e templates.

14

zabbix_atualizar_host

Operacional

Atualiza propriedades permitidas de um host existente, como nome visível, descrição, status de monitoramento, grupos associados e macros.

15

zabbix_remover_host

Administrativo (Exige Aprovação HMAC)

Exclui permanentemente um host do Zabbix juntamente com todo o seu histórico de dados e configurações.

16

zabbix_ativar_desativar_host

Operacional

Altera o status operacional de monitoramento de um host entre 0 (Monitorado/Ativo) e 1 (Não monitorado/Desativado), pausando temporariamente todas as checagens e alertas.

17

zabbix_gerenciar_interfaces_host

Operacional

Cria, consulta e atualiza interfaces de comunicação de um host (Zabbix Agent, SNMP v1/v2c/v3, IPMI, JMX), definindo porta, IP, DNS e interface primária.

18

zabbix_associar_templates_host

Operacional

Vincula um ou mais templates a um host existente no Zabbix preservando intactos todos os templates que já estavam previamente vinculados.

19

zabbix_desassociar_templates_host

Operacional

Remove a associação de templates de um host, oferecendo a opção de limpeza (unlink_and_clear) para remover do host os itens e gráficos herdados daquele template.

20

zabbix_consultar_disponibilidade_host

Somente Leitura

Inspeciona o estado operacional das interfaces de comunicação do host (Agent, SNMP, IPMI, JMX): se estão disponíveis (1), indisponíveis com erro (2) ou desconhecidas (0), exibindo mensagens de erro de polling se houver.

Categoria 3 — Coleta de Dados e Métricas

#

Ferramenta

Nível

Para que serve

21

zabbix_listar_itens

Somente Leitura

Lista os itens de telemetria cadastrados no Zabbix com filtros por host, chave de item (ex: system.

22

zabbix_consultar_item

Somente Leitura

Recupera a configuração completa de um item específico: chave, intervalo de atualização, período de retenção de histórico/trends, tipo de valor, pré-processamento e estado de erro.

23

zabbix_criar_item

Operacional

Cria um novo item de coleta customizado em um host com chave, tipo de informação, intervalo de atualização e parâmetros validados.

24

zabbix_atualizar_item

Operacional

Modifica parâmetros permitidos de um item de coleta, como intervalo de atualização (delay), período de histórico, status (habilitado/desabilitado) e descrição.

25

zabbix_consultar_historico

Somente Leitura

Recupera os registros históricos pontuais de valores de um ou mais itens em uma janela temporal (numéricos float, inteiros, strings ou logs), com ordenação cronológica.

26

zabbix_consultar_tendencias

Somente Leitura

Recupera dados consolidados por hora de tendências estatísticas (trends: valor mínimo, médio e máximo) calculados pelo Zabbix para longos períodos de tempo.

27

zabbix_ultimos_valores

Somente Leitura

Consulta a última leitura válida recebida (lastvalue), horário da última coleta e unidade de medida de todos os itens ou de itens filtrados de um host.

28

zabbix_verificar_coleta

Somente Leitura

Analisa se os itens habilitados estão realmente recebendo dados dentro do intervalo esperado (delay), identificando itens atrasados ou com erros de polling.

29

zabbix_detectar_lacunas_coleta

Somente Leitura

Examina o histórico de um item e detecta 'buracos' ou lacunas temporais (gaps) onde dados deveriam ter sido coletados mas não foram, calculando a duração de cada falha.

30

zabbix_diagnosticar_coleta

Somente Leitura

Produz um diagnóstico inteligente correlacionando erros de itens não suportados (unsupported items), indisponibilidade de interface e atrasos na fila de coleta do host.

Categoria 4 — Problemas, Triggers e Eventos

#

Ferramenta

Nível

Para que serve

31

zabbix_listar_problemas

Somente Leitura

Lista incidentes e problemas ativos no ambiente com suporte a filtros por severidade (Informational até Disaster), host, grupo, status de reconhecimento e tags.

32

zabbix_consultar_problema

Somente Leitura

Retorna os detalhes analíticos completos de um problema específico: evento gerador, trigger associada, tags, tempo de duração, severidade e mensagens de reconhecimento.

33

zabbix_consultar_eventos

Somente Leitura

Consulta a linha do tempo de eventos de problemas (geração e recuperação) no Zabbix, permitindo filtrar por janela temporal, host e severidade.

34

zabbix_listar_triggers

Somente Leitura

Lista as regras de alerta (triggers) configuradas no Zabbix com seus respectivos estados (0=OK, 1=Problem), expressões de gatilho, severidades e status (ativa/inativa).

35

zabbix_consultar_trigger

Somente Leitura

Recupera a definição técnica detalhada de uma trigger: expressão matemática exata, expressão de recuperação, prioridade, modo de geração de eventos e dependências.

36

zabbix_criar_trigger

Operacional

Cria uma nova regra de trigger customizada vinculada a itens de um host com expressão sintaticamente validada e nível de severidade configurável.

37

zabbix_atualizar_trigger

Operacional

Atualiza propriedades permitidas de uma trigger: expressão, severidade, status de habilitação, descrição e tags de correlação.

38

zabbix_reconhecer_problema

Operacional

Registra o reconhecimento formal (Acknowledge) de um problema ativo no Zabbix, permitindo anexar uma mensagem de justificativa/chamado e opcionalmente alterar a severidade ou fechar o evento.

39

zabbix_obter_historico_problema

Somente Leitura

Recupera o histórico completo de ações de um problema: quando iniciou, quem reconheceu, comentários adicionados, escalonamentos de notificação e horário de fechamento.

40

zabbix_investigar_incidente

Somente Leitura

Executa uma investigação holística de causa raiz para um incidente: correlaciona o problema com as métricas do host no exato momento da falha, eventos concomitantes e alertas relacionados.

Categoria 5 — Relatórios e Exportações

#

Ferramenta

Nível

Para que serve

41

zabbix_gerar_relatorio_executivo

Somente Leitura

Consolida indicadores executivos do ambiente: total de hosts monitorados, distribuição por severidade de problemas ativos, taxa geral de saúde e principais gargalos em formato de alto nível.

42

zabbix_gerar_relatorio_disponibilidade

Somente Leitura

Calcula a disponibilidade percentual (uptime vs downtime) de hosts e serviços no período selecionado, fundamentado em dados reais de triggers e eventos.

43

zabbix_gerar_relatorio_problemas

Somente Leitura

Agrupa e analisa todos os incidentes ocorridos no período por severidade, tempo médio de duração, hosts mais incidentados (Top Problematic Hosts) e taxa de resolução.

44

zabbix_gerar_relatorio_desempenho

Somente Leitura

Analisa o perfil de consumo de recursos computacionais (CPU, memória RAM, tráfego de rede e espaço em disco) apontando picos, médias e desvios de capacidade.

45

zabbix_gerar_relatorio_inventario

Somente Leitura

Mapeia todo o parque instalado: sistemas operacionais, localizações físicas/virtuais, números de série, versões de software e cobertura de monitoramento por grupo.

46

zabbix_gerar_relatorio_capacidade

Somente Leitura

Analisa tendências de consumo de armazenamento (disco) e memória para prever dias até a exaustão (Days Until Full / Runway) com base no crescimento histórico.

47

zabbix_gerar_relatorio_sla

Somente Leitura

Calcula os índices de cumprimento de acordos de nível de serviço (SLA) para serviços de negócio configurados, apontando tempo de conformidade e violações.

48

zabbix_exportar_relatorio_pdf

Somente Leitura

Converte os dados de qualquer relatório estruturado em um documento PDF corporativo profissional, com cabeçalho, tabelas zebradas, sumário executivo e layout limpo.

49

zabbix_exportar_relatorio_excel

Somente Leitura

Gera planilhas nativas em formato Microsoft Excel (.

50

zabbix_agendar_relatorio

Operacional

Configura agendamentos nativos de relatórios no Zabbix Server (Zabbix 6.

Categoria 6 — Alertas, Ações e Notificações

#

Ferramenta

Nível

Para que serve

51

zabbix_listar_alertas

Somente Leitura

Consulta a fila de alertas gerados pelo Zabbix, permitindo filtrar por destinatário, período, canal de mídia (E-mail, Telegram, Slack) e status de envio (enviado/falhou).

52

zabbix_consultar_acoes

Somente Leitura

Lista as regras de ações (actions) configuradas no Zabbix para tratamento de triggers, descoberta de rede, autorregistro ou serviços internos.

53

zabbix_consultar_historico_notificacoes

Somente Leitura

Recupera o histórico cronológico de notificações enviadas para um determinado usuário ou host, facilitando a correlação de alertas.

54

zabbix_listar_canais_notificacao

Somente Leitura

Lista os tipos de mídia (media types) configurados no Zabbix Server (SMTP, SMS, Webhooks para Jira/ServiceNow/Teams/Slack, scripts personalizados).

55

zabbix_testar_canal_notificacao

Operacional

Dispara um teste controlado de envio através de um tipo de mídia específico para validar a conectividade e integridade das credenciais configuradas.

56

zabbix_gerenciar_acoes

Operacional

Habilita, desabilita ou atualiza as propriedades operacionais de uma regra de ação do Zabbix.

57

zabbix_consultar_regras_escalonamento

Somente Leitura

Consulta a árvore de escalonamento configurada em uma ação (ex: Passo 1: notificar NOC; Passo 2 após 30m: notificar Coordenador; Passo 3 após 1h: notificar Gerente).

58

zabbix_suprimir_notificacoes

Operacional

Aplica supressão temporária manual de notificações para um problema específico ou host, impedindo o envio de novos alertas sem desativar a coleta.

59

zabbix_analisar_falsos_positivos

Somente Leitura

Examina o histórico recente de eventos para identificar triggers com comportamento de 'flapping' (oscilação contínua entre Problem e OK em curtos intervalos).

60

zabbix_recomendar_ajustes_alertas

Somente Leitura

Com base no histórico e nas oscilações de métricas, propõe ajustes técnicos fundamentados em triggers (ex: adicionar função min() ou max(), aumentar tempo de avaliação de 1m para 5m).

Categoria 7 — Serviços de Negócio, Manutenções e Mapas

#

Ferramenta

Nível

Para que serve

61

zabbix_listar_servicos

Somente Leitura

Lista a árvore de Business Services (Serviços de Negócio) configurada no Zabbix, exibindo hierarquia pai-filho e status de saúde consolidado.

62

zabbix_consultar_servico

Somente Leitura

Retorna os detalhes de um serviço de negócio específico: regras de propagação de status, triggers filhas associadas, pesos e tags de correlação.

63

zabbix_criar_servico

Operacional

Cria um novo serviço de negócio no catálogo de serviços do Zabbix, definindo seu algoritmo de cálculo de status (qualquer filho falha, todos falham, etc.

64

zabbix_atualizar_servico

Operacional

Atualiza propriedades, regras de avaliação e dependências de um serviço de negócio existente.

65

zabbix_consultar_sla_servico

Somente Leitura

Calcula os indicadores SLI (Service Level Indicator) e o cumprimento de metas de SLA para um serviço em períodos específicos (semanal, mensal, anual).

66

zabbix_listar_manutencoes

Somente Leitura

Lista todas as janelas de manutenção cadastradas no Zabbix (ativas, agendadas ou expiradas) com tipo de manutenção (com ou sem coleta de dados) e hosts afetados.

67

zabbix_criar_manutencao

Operacional

Cria uma nova janela de manutenção com horários de início e término estritos, escopo de hosts/grupos e definição se a coleta de dados deve ser mantida ou suspensa.

68

zabbix_atualizar_manutencao

Operacional

Modifica o período ou a lista de hosts contemplados em uma janela de manutenção já existente.

69

zabbix_consultar_mapas

Somente Leitura

Recupera as configurações e nós de mapas de topologia visual cadastrados no Zabbix.

70

zabbix_gerar_mapa_monitoramento

Somente Leitura

Gera dinamicamente uma representação gráfica de mapa em formato Markdown/Mermaid a partir dos hosts, grupos e status reais consultados na API do Zabbix.

Categoria 8 — Inventário, Grupos e Templates

#

Ferramenta

Nível

Para que serve

71

zabbix_consultar_inventario

Somente Leitura

Recupera os campos detalhados de inventário de um host (hardware, sistema operacional, localização geográfica, responsável técnico, número de série, vendor, notas).

72

zabbix_atualizar_inventario

Operacional

Atualiza campos de inventário permitidos de um host (modo de inventário manual/automático, tags, local físico, notas de suporte, etc.

73

zabbix_listar_grupos_hosts

Somente Leitura

Lista todos os grupos de hosts (hostgroups) cadastrados no Zabbix com seus respectivos IDs e nomes.

74

zabbix_gerenciar_grupos_hosts

Operacional

Cria, renomeia ou remove grupos de hosts no Zabbix, validando a não-existência de hosts dependentes antes de qualquer exclusão.

75

zabbix_listar_templates

Somente Leitura

Lista os templates disponíveis no Zabbix, permitindo filtrar por nome ou grupo de templates.

76

zabbix_consultar_template

Somente Leitura

Inspeciona profundamente um template específico: itens, triggers, protótipos de descoberta (LLD), gráficos, dashboards e macros herdadas.

77

zabbix_criar_template

Operacional

Cria um novo template no Zabbix com parâmetros validados, associando-o ao grupo de templates adequado.

78

zabbix_atualizar_template

Operacional

Atualiza propriedades, nome visível, descrição e macros de um template existente.

79

zabbix_gerenciar_grupos_templates

Operacional

Gerencia a criação e listagem de grupos de templates, compatível com a separação entre hostgroups e templategroups introduzida a partir do Zabbix 6.

80

zabbix_auditar_cobertura_templates

Somente Leitura

Audita todo o Zabbix em busca de falhas de governança: hosts ativos sem nenhum template vinculado, templates órfãos sem nenhum host e discrepâncias de padronização.

Categoria 9 — Descoberta Nativa, Proxies e Administração

#

Ferramenta

Nível

Para que serve

81

zabbix_listar_regras_descoberta

Somente Leitura

Lista as regras nativas de Descoberta de Rede (Network Discovery Rules - drule) configuradas no Zabbix Server/Proxy.

82

zabbix_gerenciar_regras_descoberta

Operacional

Habilita, desabilita ou altera propriedades de regras nativas de descoberta de rede (drule).

83

zabbix_consultar_descoberta_baixo_nivel

Somente Leitura

Consulta as regras LLD (Low-Level Discovery) e protótipos de itens, triggers e gráficos de um host ou template.

84

zabbix_listar_proxies

Somente Leitura

Lista todos os proxies de monitoramento distribuído cadastrados no Zabbix, indicando se operam em modo Ativo ou Passivo e seus respectivos status.

85

zabbix_consultar_proxy

Somente Leitura

Inspeciona detalhadamente o estado operacional de um proxy: última comunicação (lastaccess), lista de hosts atribuídos e endereço de conexão.

86

zabbix_gerenciar_proxies

Administrativo (Exige Aprovação HMAC para exclusão)

Cadastra, atualiza ou remove configurações de proxies no Zabbix Server.

87

zabbix_consultar_usuarios

Somente Leitura

Lista os usuários cadastrados no Zabbix com seus respectivos grupos e funções de acesso, com redação automática e mascaramento estrito de senhas ou tokens.

88

zabbix_consultar_funcoes_usuario

Somente Leitura

Consulta os papéis de acesso (User Roles) e conjuntos de permissões configurados no Zabbix (Admin, Super Admin, User).

89

zabbix_consultar_auditoria

Somente Leitura

Consulta os logs de auditoria nativos do Zabbix (Audit Log), registrando quem alterou, criou ou excluiu qualquer objeto no ambiente com IP de origem e timestamp.

90

zabbix_consultar_estado_sistema

Somente Leitura

Recupera a versão da API do Zabbix, nós do cluster de Alta Disponibilidade (HA nodes se habilitado), tamanho da fila de itens atrasados e integridade geral do servidor.

Categoria 10 — Automação, Análise e Diagnóstico Holístico

#

Ferramenta

Nível

Para que serve

91

zabbix_validar_conexao

Somente Leitura

Testa de ponta a ponta a comunicação com a API JSON-RPC do Zabbix: valida resolução de URL, certificado SSL/TLS, conectividade HTTP, autenticação via Token/Bearer e versão suportada.

92

zabbix_converter_pergunta_para_consulta

Somente Leitura

Traduz uma necessidade expressa em linguagem natural (ex: 'Quais servidores Linux tiveram consumo de CPU acima de 90% ontem?') em um plano estruturado de chamadas da API do Zabbix.

93

zabbix_explicar_metricas

Somente Leitura

Analisa estatisticamente a série temporal de um item e gera uma explicação compreensível em linguagem natural: média, volatilidade, desvio padrão, tendência de subida ou descida e limites de segurança.

94

zabbix_comparar_periodos

Somente Leitura

Compara matematicamente o comportamento de uma métrica em dois períodos temporais distintos (ex: hoje vs mesmo dia da semana passada; este mês vs mês anterior), calculando variação percentual.

95

zabbix_detectar_anomalias

Somente Leitura

Aplica modelos estatísticos de Z-Score sobre os dados históricos da métrica para identificar valores atípicos (outliers) que fogem do comportamento padrão do host.

96

zabbix_planejar_automacao

Somente Leitura

Gera um plano de execução completo passo a passo para automações complexas (onboarding, migração de templates, expurgo de hosts), detalhando pré-requisitos, validações e plano de rollback.

97

zabbix_executar_fluxo_aprovado

Operacional

Executa sequencialmente um plano de automação previamente validado e autorizado, com checagem estrita de pré-condições em cada estágio e interrupção segura em caso de imprevisto.

98

zabbix_previsualizar_alteracao

Somente Leitura

Gera uma visualização em formato de Diff (Antes vs Depois) de qualquer alteração proposta em hosts, templates, triggers ou itens, destacando claramente impactos esperados.

99

zabbix_consultar_auditoria_mcp

Somente Leitura

Consulta o arquivo local de auditoria (`audit_mcp.

100

zabbix_diagnosticar_ambiente

Somente Leitura

Produz um diagnóstico holístico 360° do ecossistema Zabbix: valida conectividade da API, saúde da fila de coleta, integridade dos proxies, proporção de problemas críticos e hosts desprotegidos.


📂 Estrutura do Repositório

zabbix-mcp-server/
├── src/zabbix_mcp/
│   ├── server.py              # Ponto de entrada FastMCP / MCPServer (100 ferramentas registradas)
│   ├── config.py              # Pydantic Settings e validação de ambiente
│   ├── client.py              # Cliente assíncrono httpx com JSON-RPC 2.0 e retries
│   ├── api_compatibility.py   # Detecção de versão e matriz de recursos
│   ├── models.py              # Contratos Pydantic de entrada e saída (ToolResult)
│   ├── security.py            # Redação de segredos e prevenção de SSRF/Path Traversal
│   ├── authorization.py       # Modos de autorização RBAC
│   ├── policies.py            # Tokens de aprovação HMAC em 2 passos
│   ├── audit.py               # Motor de auditoria local em JSONL
│   ├── discovery/             # Onboarding automatizado em 6 estágios (A ao F)
│   ├── reports/               # Motor de exportação PDF, Excel, CSV, JSON e MD
│   └── tools/                 # As 100 ferramentas divididas em 10 categorias modulares
├── tests/
│   ├── unit/                  # Testes unitários (inventário das 100 ferramentas, RBAC, etc.)
│   └── integration/           # Testes de integração contra Zabbix real
├── docs/                      # 9 Guias detalhados de arquitetura, ferramentas e segurança
│   ├── instalacao.md          # Manual de instalação multi-plataforma
│   ├── configuracao.md        # Tabela completa de variáveis e clientes MCP
│   ├── ferramentas.md         # Manual definitivo das 100 ferramentas com parâmetros
│   └── solucao-de-problemas.md# Guia de troubleshooting e diagnósticos
├── Dockerfile                 # Imagem de produção sem privilégios de root
├── compose.yaml               # Docker Compose com suporte a transporte SSE
└── pyproject.toml             # Metadados e dependências do projeto

📄 Licença

Este projeto está licenciado sob a Licença MIT.

Available Tools

100 tools
zabbix_agendar_relatorioC
  1. Criar ou atualizar agendamento de relatório nativo do Zabbix (Scheduled Reports).

Inputs: nome (required), periodo, email_destinatario. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_analisar_dispositivoC
  1. Analisar endereço IP, DNS, portas permitidas e evidências de identificação.

Inputs: ip (required), portas. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_analisar_falsos_positivosC
  1. Identificar padrões suspeitos de alertas recorrentes (flapping) e sugerir ajustes.

Inputs: periodo_dias. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_associar_templates_hostB
  1. Associar templates compatíveis ao host mantendo os existentes.

Inputs: hostid (required), templates_ids (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_ativar_desativar_hostC
  1. Alterar o status de monitoramento de um host.

Inputs: hostid (required), status (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_hostC
  1. Atualizar propriedades permitidas de um host.

Inputs: hostid (required), status, descricao, nome_visivel. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_inventarioC
  1. Atualizar campos de inventário permitidos de um host (ex: os, location, tag, notes).

Inputs: hostid (required), campos_inventario (required), modo_inventario. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_itemC
  1. Atualizar configurações permitidas de um item.

Inputs: itemid (required), name, delay, status. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_manutencaoC
  1. Alterar uma janela de manutenção autorizada.

Inputs: maintenanceid (required), active_till, description. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_servicoC
  1. Atualizar propriedades e regras de um serviço.

Inputs: serviceid (required), name, algorithm. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_templateC
  1. Atualizar propriedades e objetos de um template.

Inputs: templateid (required), name, description. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_atualizar_triggerC
  1. Atualizar propriedades suportadas de uma trigger.

Inputs: triggerid (required), status, comments, priority. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_auditar_cobertura_templatesB
  1. Auditar hosts sem templates adequados, associações vazias e possíveis lacunas.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_cadastrar_dispositivos_em_loteC
  1. Cadastrar vários dispositivos aprovados, com validação individual e relatório de resultados.

Inputs: previsoes (required), token_aprovacao. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_comparar_dispositivos_cadastradosC
  1. Comparar a descoberta com o inventário atual.

Inputs: ips_descobertos (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_comparar_periodosC
  1. Comparar o comportamento de uma métrica entre dois períodos equivalentes.

Inputs: itemid (required), periodo_1_fim (required), periodo_2_fim (required), periodo_1_inicio (required), +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_acoesC
  1. Listar ações configuradas para eventos.

Inputs: eventsource. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_auditoriaC
  1. Consultar registros nativos de auditoria do Zabbix (Audit Log).

Inputs: limite. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_auditoria_mcpC
  1. Consultar o histórico local de chamadas e comandos das ferramentas MCP.

Inputs: limite, apenas_erros. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_descoberta_baixo_nivelC
  1. Consultar regras LLD (Low-Level Discovery) e protótipos.

Inputs: hostid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_disponibilidade_hostC
  1. Consultar a disponibilidade e o estado observável do host.

Inputs: hostid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_estado_sistemaB
  1. Recuperar versão do Zabbix, nós de HA, fila e estado geral do sistema.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_eventosC
  1. Consultar eventos por host, período, severidade ou objeto.

Inputs: hostid, limite, tempo_de, tempo_ate, +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_funcoes_usuarioB
  1. Consultar funções e papéis de usuário (User Roles) e permissões.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_historicoC
  1. Consultar dados históricos de itens.

Inputs: itemid (required), limite, tempo_de, tempo_ate, +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_historico_notificacoesC
  1. Consultar notificações e seus resultados quando disponíveis.

Inputs: tempo_de, tempo_ate, apenas_falhas. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_hostC
  1. Consultar detalhes completos de um host.

Inputs: nome, hostid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_inventarioC
  1. Consultar inventário de hardware, software e metadados de hosts.

Inputs: hostid, limite, offset. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_itemC
  1. Consultar configuração e metadados de um item.

Inputs: itemid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_mapasB
  1. Consultar mapas de topologia e seus elementos configurados.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_problemaC
  1. Consultar detalhes e identificadores de um problema específico.

Inputs: eventid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_proxyB
  1. Consultar detalhes, latência e estado observável de um proxy.

Inputs: proxyid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_regras_escalonamentoC
  1. Consultar condições e etapas de escalonamento configuradas.

Inputs: actionid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_servicoB
  1. Consultar status e dependências de um serviço.

Inputs: serviceid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_sla_servicoC
  1. Consultar indicadores de SLA e Service Level Indicators (SLI) de um serviço.

Inputs: serviceid (required), periodo_dias. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_templateC
  1. Consultar configurações, itens, triggers e macros de um template.

Inputs: templateid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_tendenciasC
  1. Recuperar tendências (trends) para períodos disponíveis.

Inputs: itemid (required), tempo_de (required), tempo_ate (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_triggerC
  1. Consultar expressão, estado e metadados de uma trigger.

Inputs: triggerid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_consultar_usuariosB
  1. Consultar usuários cadastrados (sem expor senhas ou tokens).

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_converter_pergunta_para_consultaC
  1. Transformar uma pergunta em linguagem natural em um plano de consulta à API do Zabbix.

Inputs: pergunta_em_portugues (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_criar_hostC
  1. Criar um host com parâmetros validados.

Inputs: ip (required), host (required), grupos_ids (required), porta, +4 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_criar_itemC
  1. Criar itens de coleta quando suportado e autorizado.

Inputs: key_ (required), name (required), hostid (required), type, +4 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_criar_manutencaoC
  1. Criar uma janela de manutenção com período e escopo explícitos.

Inputs: name (required), active_till (required), active_since (required), hostids, +2 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_criar_servicoC
  1. Criar um serviço de negócio com relações válidas.

Inputs: name (required), algorithm, sortorder, parent_serviceid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_criar_templateC
  1. Criar novo template no Zabbix.

Inputs: host (required), name, grupos_ids, description. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_criar_triggerC
  1. Criar triggers quando permitido e com validação da expressão.

Inputs: expression (required), description (required), comments, priority. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_deduplicar_dispositivosC
  1. Identificar possíveis duplicidades entre dispositivos descobertos e hosts existentes.

Inputs: dispositivos (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_desassociar_templates_hostC
  1. Remover associações de templates com opção de limpeza (unlink / clear).

Inputs: hostid (required), templates_ids (required), limpar_itens_triggers. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_descobrir_redeC
  1. Descobrir dispositivos em uma faixa de rede explicitamente autorizada.

Inputs: faixa_cidr (required), portas, limite_hosts, confirmar_escopo_autorizado. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_detectar_anomaliasC
  1. Identificar anomalias estatísticas nos dados disponíveis usando Z-Score.

Inputs: itemid (required), desvios_padrao, limite_amostras. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_detectar_lacunas_coletaC
  1. Identificar lacunas temporais (gaps) na coleta de um item.

Inputs: itemid (required), tempo_de (required), tempo_ate (required), tolerancia_multiplicador. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_diagnosticar_ambienteB
  1. Produzir um diagnóstico holístico 360° de conectividade, descoberta, coleta, alertas e saúde do Zabbix.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_diagnosticar_coletaC
  1. Correlacionar erros, disponibilidade, intervalos e dados ausentes do host.

Inputs: hostid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_executar_fluxo_aprovadoC
  1. Executar um fluxo de automação previamente validado e autorizado.

Inputs: plano (required), token_aprovacao (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_explicar_metricasC
  1. Explicar métricas e tendências com base em dados recuperados do item.

Inputs: itemid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_exportar_relatorio_excelC
  1. Gerar planilha XLSX com dados estruturados e abas pertinentes.

Inputs: nome_arquivo, periodo_dias, tipo_relatorio. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_exportar_relatorio_pdfC
  1. Gerar documento PDF corporativo com cabeçalho, período, tabelas e conclusões.

Inputs: nome_arquivo, periodo_dias, tipo_relatorio. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_mapa_monitoramentoC
  1. Construir uma representação visual (Mermaid diagram) dos hosts e grupos usando dados reais.

Inputs: grupo_nome. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_capacidadeC
  1. Analisar tendências e indicadores de capacidade com base nos dados disponíveis.

Inputs: hostid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_desempenhoC
  1. Analisar métricas de CPU, memória, disco e rede quando disponíveis.

Inputs: hostid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_disponibilidadeC
  1. Gerar relatório de disponibilidade de hosts e serviços.

Inputs: grupo_nome, periodo_dias. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_executivoC
  1. Gerar um resumo executivo consolidado do estado do ambiente.

Inputs: grupo_nome, periodo_dias. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_inventarioB
  1. Gerar relatório de inventário e cobertura de monitoramento.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_problemasC
  1. Consolidar problemas por período, host e severidade.

Inputs: periodo_dias, severidade_minima. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerar_relatorio_slaC
  1. Gerar relatório de SLA usando definições e dados adequados.

Inputs: slaid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerenciar_acoesC
  1. Habilitar, desabilitar ou atualizar ações conforme a API.

Inputs: actionid (required), acao_tipo (required), nome. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerenciar_grupos_hostsC
  1. Criar, atualizar ou excluir grupos de hosts com as verificações necessárias.

Inputs: acao (required), nome, groupid, token_aprovacao. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerenciar_grupos_templatesC
  1. Consultar e gerenciar grupos de templates (templategroup ou hostgroup conforme versão).

Inputs: acao, nome. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerenciar_interfaces_hostC
  1. Criar, consultar e atualizar interfaces suportadas do host.

Inputs: acao (required), hostid (required), interface_dados. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerenciar_proxiesB
  1. Gerenciar proxies (criar, atualizar ou excluir com aprovação).

Inputs: acao (required), nome, proxyid, operating_mode, +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_gerenciar_regras_descobertaD
  1. Gerenciar regras nativas de descoberta de rede (drule).

Inputs: acao (required), druleid (required), iprange. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_identificar_servicosC
  1. Identificar serviços monitoráveis usando métodos autorizados e não intrusivos.

Inputs: ip (required), portas_abertas (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_identificar_sistema_operacionalC
  1. Inferir o sistema operacional a partir de dados confiáveis, indicando o grau de confiança.

Inputs: ip (required), portas_abertas (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_investigar_incidenteC
  1. Correlacionar problemas, hosts, itens e eventos para produzir uma investigação fundamentada.

Inputs: eventid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_alertasD
  1. Consultar problemas e alertas conforme o escopo selecionado.

Inputs: limite, offset, eventid. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_canais_notificacaoC
  1. Listar tipos de mídia configurados e metadados permitidos (Media Types).

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_grupos_hostsC
  1. Listar grupos de hosts cadastrados.

Inputs: nome. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_hostsC
  1. Listar hosts com filtros por nome, grupo, status e disponibilidade.

Inputs: nome, grupo, limite, offset, +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_itensC
  1. Listar itens de coleta com filtros por host, chave, tipo e status.

Inputs: chave, hostid, limite, offset, +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_manutencoesC
  1. Listar períodos de manutenção configurados.

Inputs: limite, offset. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_problemasC
  1. Listar problemas ativos com filtros de severidade e status.

Inputs: hostid, limite, offset, reconhecido, +1 more. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_proxiesB
  1. Listar proxies cadastrados no Zabbix.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_regras_descobertaB
  1. Listar regras nativas de descoberta de rede (Network Discovery Rules).

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_servicosC
  1. Listar serviços de negócio disponíveis (Business Services).

Inputs: limite, offset. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_templatesC
  1. Listar templates disponíveis e associações no Zabbix.

Inputs: nome, limite, offset. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_listar_triggersC
  1. Listar triggers e suas configurações.

Inputs: hostid, limite, offset, status. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_obter_historico_problemaC
  1. Recuperar o histórico e os eventos associados ao problema.

Inputs: eventid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_planejar_automacaoC
  1. Elaborar um plano de execução com etapas, dependências e permissões necessárias.

Inputs: etapas_propostas (required), descricao_objetivo (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_previsualizar_alteracaoC
  1. Mostrar alterações propostas e impactos esperados antes da aplicação.

Inputs: acao (required), parametros (required), objeto_tipo (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_previsualizar_cadastroB
  1. Apresentar todos os parâmetros propostos para cadastrar um dispositivo sem efetuar alterações.

Inputs: dispositivo (required), templates, grupo_destino. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_recomendar_ajustes_alertasB
  1. Recomendar alterações técnicas em triggers com justificativas sem aplicá-las silenciosamente.

Inputs: triggerid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_recomendar_templatesC
  1. Recomendar templates conforme sistema operacional, serviços e compatibilidade.

Inputs: portas_abertas (required), sistema_operacional (required), tipo_dispositivo. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_reconhecer_problemaC
  1. Reconhecer (Acknowledge) um problema com mensagem de auditoria.

Inputs: eventid (required), mensagem (required), acao. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_remover_hostB
  1. Remover um host somente após validação e confirmação (Ação destrutiva).

Inputs: hostid (required), token_aprovacao. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_suprimir_notificacoesC
  1. Implementar supressão temporária de alertas de problemas.

Inputs: eventids (required), suprimir_ate (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_testar_canal_notificacaoC
  1. Testar um canal somente em ambiente e condições autorizados.

Inputs: mediatypeid (required), destinatario (required), mensagem, confirmar_envio. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_ultimos_valoresC
  1. Consultar os últimos valores recebidos dos itens do host.

Inputs: hostid (required), filtro_chave. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_validar_conexaoB
  1. Validar URL, conectividade de rede, autenticação e versão da API Zabbix.

Inputs: no named parameters. Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_verificar_coletaC
  1. Verificar se os itens ativos estão coletando dados dentro dos prazos esperados.

Inputs: hostid (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

zabbix_verificar_descobertaC
  1. Verificar o resultado da descoberta, identificando falhas, duplicidades e dispositivos não resolvidos.

Inputs: hostids (required). Returns: Contrato padronizado de resposta para todas as ferramentas MCP.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 100 tools

    Disambiguation2/5

    Many tools overlap heavily: listar/consultar pairs exist for hosts, items, triggers, problems, templates and proxies, while 'gerenciar' tools (grupos_hosts, acoes, proxies, regras_descoberta, grupos_templates) partially duplicate the dedicated create/update/delete tools. Seven gerar_relatorio_* variants (executivo, disponibilidade, problemas, desempenho, inventario, capacidade, sla) plus consultar_sla_servico and gerar_relatorio_sla are hard to separate, and diagnosticar_coleta/verificar_coleta/detectar_lacunas_coleta/diagnosticar_ambiente form a fuzzy cluster. An agent can often guess, but misselection is likely.

    Naming Consistency4/5

    All names follow the zabbix_ prefix plus snake_case Portuguese verb_noun convention, which is predictable and readable. Minor deviations exist (mixed verb families like listar vs consultar for reads, and bundling verbs like gerenciar/ativar_desativar that combine multiple actions into one name), but the pattern itself is stable throughout.

    Tool Count1/5

    100 tools for a single Zabbix integration is an extreme surface that far exceeds what an agent can reliably navigate, and the rubric places 50+ tools at the bottom. Many entries are hyper-granular (checking gaps, comparing periods, explaining metrics) and could be collapsed into a handful of parameterized tools.

    Completeness4/5

    Coverage is broad: hosts, items, triggers, problems, events, services, maintenance, maps, inventory, templates, discovery rules/LLD, proxies, users, audit and system state, plus reporting and analytics. Gaps remain around write operations for some resources (no delete_item, delete_trigger, delete_service, delete_maintenance, delete_template), and user/dashboard/script management is read-only or absent, but agents can work around most of these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      🔌 Complete MCP server for Zabbix integration - Connect AI assistants to Zabbix monitoring with 40+ tools for hosts, items, triggers, templates, problems, and more. Features read-only mode and comprehensive API coverage.
      3
      263
      GPL 3.0
    • A
      license
      B
      quality
      A
      maintenance
      Official initMAX MCP server exposing the Zabbix API to AI assistants for monitoring and managing hosts, problems, templates, dashboards, and multiple Zabbix instances. Includes correlated monitoring views, graphs, anomaly detection, capacity forecasts, and PDF reports, with scoped tokens, read-only modes, OAuth 2.1, and an admin portal. Supports Streamable HTTP, SSE, and stdio.
      84
      251
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Zabbix MCP server and CLI in one Go binary. 15 task-shaped tools: current problems, host investigation, why an alert did or did not arrive, metrics, maintenance. Zabbix 6.4+.
      15
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to query and manage Zabbix monitoring data—hosts, items, triggers, problems, and health checks—and generate daily, weekly, and monthly operations reports.
      21
      GPL 3.0