vfcastr/zabbix-mcp

6 stars 4 forks Quality 57 Trend 14

Model Context Protocol (MCP) server implementation for Zabbix 7.0 LTS

Overview

Model Context Protocol (MCP) server implementation for Zabbix 7.0 LTS Features • Prerequisites • Quick Start • Configuration • Tools A Model Context Protocol (MCP) server implementation for . Provides comprehensive integration with Zabbix for managing hosts, items, triggers, templates, maintenance, problems, events, user macros, LLD rules, proxies, user management, and more. : We recommend running via Docker as it is the most tested deployment method. The MCP server is intended for local use only. If using HTTP transport, configure MCP_ALLOWED_ORIGINS to restrict access to trusted origins.

README

Zabbix MCP Server

Model Context Protocol (MCP) server implementation for Zabbix 7.0 LTS

Features • Prerequisites • Quick Start • Configuration • Tools

A Model Context Protocol (MCP) server implementation for Zabbix 7.0 LTS. Provides comprehensive integration with Zabbix for managing hosts, items, triggers, templates, maintenance, problems, events, user macros, LLD rules, proxies, user management, and more.

🐳 Recommended: We recommend running via Docker as it is the most tested deployment method.

Security Note: The MCP server is intended for local use only. If using HTTP transport, configure MCP_ALLOWED_ORIGINS to restrict access to trusted origins.

🚀 Features

79 MCP Tools covering the full Zabbix API
Host, Item, Trigger, and Template Management
Host Groups, Template Groups, and Proxy Groups
Problem and Event Management with acknowledgement
User, User Group, and User Role Management
User Macro Management (Host and Global)
Low-Level Discovery (LLD) Rules and Prototypes
Proxy Management
Audit Log Access
Built-in Zabbix API Documentation Search
Stdio and HTTP transports
Session-based Zabbix client with structured logging

📋 Prerequisites

Docker (recommended)
Go 1.24+ (if building from source)
Zabbix 7.0 LTS server
Valid Zabbix API Token

⚡ Quick Start

Build the Docker Image

docker build -t zabbix-mcp:latest .

Run in HTTP Mode

docker run -p 8080:8080 --rm \
    -e ZABBIX_URL='http://your-zabbix-server/api_jsonrpc.php' \
    -e ZABBIX_TOKEN='your-api-token' \
    -e TRANSPORT_MODE='http' \
    zabbix-mcp:latest

Run in Stdio Mode

docker run -i --rm \
    -e ZABBIX_URL='http://your-zabbix-server/api_jsonrpc.php' \
    -e ZABBIX_TOKEN='your-api-token' \
    zabbix-mcp:latest

⚙️ Configuration

MCP Client Configuration

Configuration examples are provided in the repository for popular MCP clients:

Claude Code (`claude.json`)

{
    "mcpServers": {
        "Zabbix": {
            "type": "http",
            "url": "YOUR-ZABBIX-MCP-SERVER-URL/mcp",
            "headers": {
                "X-Zabbix-URL": "YOUR-ZABBIX-URL",
                "X-Zabbix-Token": "YOUR-ZABBIX-TOKEN"
            }
        }
    }
}

GitHub Copilot (`github_copilot.json`)

{
    "servers": {
        "Zabbix MCP Server": {
            "type": "http",
            "url": "YOUR-ZABBIX-MCP-SERVER-URL/mcp",
            "headers": {
                "X-Zabbix-URL": "YOUR-ZABBIX-URL/api_jsonrpc.php",
                "X-Zabbix-Token": "YOUR-ZABBIX-TOKEN"
            }
        }
    }
}

Google Gemini (`gemini.json`)

{
  "name": "zabbix-mcp-server",
  "version": "1.0.0",
  "description": "Zabbix MCP Server for managing Zabbix 7.0 LTS",
  "publisher": "vfcastr",
  "mcp": {
    "command": "./zabbix-mcp-server",
    "args": ["stdio"],
    "env": {
      "ZABBIX_URL": "${ZABBIX_URL}",
      "ZABBIX_TOKEN": "${ZABBIX_TOKEN}"
    }
  }
}

Environment Variables

Variable	Description	Default
`ZABBIX_URL`	Zabbix API URL	`http://127.0.0.1/api_jsonrpc.php`
`ZABBIX_TOKEN`	Zabbix API Token	(required)
`ZABBIX_SKIP_VERIFY`	Skip TLS verification	`false`
`TRANSPORT_MODE`	Transport mode (`http` or `stdio`)	`stdio`
`TRANSPORT_PORT`	HTTP port	`8080`
`LOG_LEVEL`	Log level	`info`

🛠️ Tools

Total: 79 Tools Included

🖥️ Host Management

Tool	Description
`get_hosts`	List hosts with filters
`create_host`	Create a new host
`update_host`	Update host properties
`delete_host`	Delete hosts

📂 Host Group Management

Tool	Description
`zabbix_get_host_groups`	List host groups
`zabbix_create_host_group`	Create host group
`zabbix_update_host_group`	Update host group
`zabbix_delete_host_group`	Delete host groups

📊 Item Management

Tool	Description
`get_items`	List monitoring items
`create_item`	Create item
`update_item`	Update item
`delete_item`	Delete items
`get_history`	Get historical item values

⚡ Trigger Management

Tool	Description
`get_triggers`	List triggers
`create_trigger`	Create trigger
`update_trigger`	Update trigger
`delete_trigger`	Delete triggers

📋 Template Management

Tool	Description
`get_templates`	List templates
`create_template`	Create template
`update_template`	Update template
`delete_template`	Delete templates
`link_template`	Link template to host
`unlink_template`	Unlink template from host

📁 Template Group Management

Tool	Description
`zabbix_get_template_groups`	List template groups
`zabbix_create_template_group`	Create template group
`zabbix_update_template_group`	Update template group
`zabbix_delete_template_group`	Delete template groups

🛠️ Maintenance Management

Tool	Description
`get_maintenance`	List maintenance windows
`create_maintenance`	Create maintenance window
`update_maintenance`	Update maintenance window
`delete_maintenance`	Delete maintenance windows

🚨 Problem & Event Management

Tool	Description
`get_problems`	Get current problems
`get_events`	Get events
`acknowledge_event`	Acknowledge/update events
`get_trends`	Get trend data
`get_alerts`	Get alerts

👥 User Management

Tool	Description
`get_users`	List users
`create_user`	Create user
`update_user`	Update user
`delete_user`	Delete users

👥 User Group Management

Tool	Description
`get_user_groups`	List user groups
`create_user_group`	Create user group
`update_user_group`	Update user group
`delete_user_group`	Delete user groups

🎭 User Role Management

Tool	Description
`get_user_roles`	List user roles
`create_user_role`	Create user role
`update_user_role`	Update user role
`delete_user_role`	Delete user roles

🔢 Macro Management

Global Macros

Tool	Description
`get_global_macros`	Get global macros
`create_global_macro`	Create global macro
`update_global_macro`	Update global macro
`delete_global_macro`	Delete global macro

Host User Macros

Tool	Description
`get_user_macros`	Get host macros
`create_user_macro`	Create host macro
`update_user_macro`	Update host macro
`delete_user_macro`	Delete host macro

🌐 Proxy Management

Tool	Description
`zabbix_get_proxies`	List proxies
`zabbix_create_proxy`	Create proxy
`zabbix_update_proxy`	Update proxy
`zabbix_delete_proxies`	Delete proxies

🌐 Proxy Group Management

Tool	Description
`zabbix_get_proxy_groups`	List proxy groups
`zabbix_create_proxy_group`	Create proxy group
`zabbix_update_proxy_group`	Update proxy group
`zabbix_delete_proxy_groups`	Delete proxy groups

🔍 LLD (Low-Level Discovery)

Tool	Description
`get_lld_rules`	Get discovery rules
`create_lld_rule`	Create LLD rule
`update_lld_rule`	Update LLD rule
`delete_lld_rule`	Delete LLD rules
`copy_lld_rule`	Copy LLD rule to hosts

🧩 Prototypes

Item Prototypes

Tool	Description
`get_item_prototypes`	Get item prototypes
`create_item_prototype`	Create item prototype
`update_item_prototype`	Update item prototype
`delete_item_prototype`	Delete item prototypes

Trigger Prototypes

Tool	Description
`get_trigger_prototypes`	Get trigger prototypes
`create_trigger_prototype`	Create trigger prototype
`update_trigger_prototype`	Update trigger prototype
`delete_trigger_prototype`	Delete trigger prototypes

📜 Audit & Documentation

Tool	Description
`get_audit_log`	Get audit log entries
`get_zabbix_docs`	Search Zabbix API documentation

🏗️ Building from Source

git clone https://github.com/vfcastr/Zabbix-MCP.git
cd Zabbix-MCP
go build -ldflags="-X github.com/vfcastr/Zabbix-MCP/version.Version=1.0.0" -o zabbix-mcp-server ./cmd/zabbix-mcp-server

📂 Project Structure

Zabbix-MCP/
├── cmd/zabbix-mcp-server/     # Entry point
├── pkg/
│   ├── client/                # Zabbix API client
│   └── tools/                 # MCP tools (79 tools)
│       ├── hosts/             # Host management
│       ├── hostgroups/        # Host group management
│       ├── items/             # Item management
│       ├── triggers/          # Trigger management
│       ├── templates/         # Template management
│       ├── templategroups/    # Template group management
│       ├── maintenance/       # Maintenance windows
│       ├── problems/          # Problem management
│       ├── events/            # Event management
│       ├── trends/            # Trend data
│       ├── alerts/            # Alert management
│       ├── users/             # User management
│       ├── usergroups/        # User group management
│       ├── userroles/         # User role management
│       ├── macros/            # User macros (host & global)
│       ├── proxies/           # Proxy management
│       ├── proxygroups/       # Proxy group management
│       ├── lld/               # LLD rules
│       ├── itemprototypes/    # Item prototypes
│       ├── triggerprototypes/ # Trigger prototypes
│       ├── auditlog/          # Audit log
│       └── docs/              # Documentation tool
├── version/                   # Version info
├── claude.json                # Claude Code config example
├── github_copilot.json        # GitHub Copilot config example
├── gemini.json                # Google Gemini config example
├── zabbix_documentation.md    # Zabbix API docs
├── Dockerfile
├── go.mod
└── README.md

📝 License

MPL-2.0

👤 Author

Created by vfcastr

View the full README on GitHub

Install

docker run -p 8080:8080 --rm \

New to MCP? Start with the mcpskill.org guide →

Configuration

{
    "mcpServers": {
        "Zabbix": {
            "type": "http",
            "url": "YOUR-ZABBIX-MCP-SERVER-URL/mcp",
            "headers": {
                "X-Zabbix-URL": "YOUR-ZABBIX-URL",
                "X-Zabbix-Token": "YOUR-ZABBIX-TOKEN"
            }
        }
    }
}