# initmax/zabbix-mcp-server architecture

> Architecture diagram of the GitHub repository initmax/zabbix-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/initmax/zabbix-mcp-server
- Repository: https://github.com/initmax/zabbix-mcp-server

## Overview

Zabbix MCP Server exposes Zabbix operations as tools for AI clients over HTTP or SSE. The main path is client request → MCP server/tool dispatch → API method or extension → Zabbix instance → returned result. Operators manage configuration, tokens, users, templates, and audit records through a separate admin portal; OAuth, multi-server access, and PDF reporting are additional capabilities. The graph follows documented capabilities and source-index references; unsampled subsystem internals and their finer-grained links are not inferred.

Main entry points: [`src/zabbix_mcp/server.py`](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/server.py) (MCP Server), [`src/zabbix_mcp/admin/views`](https://github.com/initmax/zabbix-mcp-server/tree/main/src/zabbix_mcp/admin/views) (Admin Views), [`src/zabbix_mcp/api/common.py`](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/common.py) (API Common), [`src/zabbix_mcp/api/data_collection.py`](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/data_collection.py) (Data Collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["MCP Runtime"]
  node_mcp["MCP Server<br/>[server.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_zclient["Zabbix Client<br/>[client.py]"]
end

subgraph group_api["Zabbix API Tools"]
  node_common["API Common<br/>[common.py]"]
  node_collection["Data Collection<br/>[data_collection.py]"]
  node_monitoring["Monitoring Tools<br/>[monitoring.py]"]
  node_alerts["Alert Tools<br/>[alerts.py]"]
  node_usersapi["User Tools<br/>[users.py]"]
  node_administration["Administration Tools<br/>[administration.py]"]
  node_extensions["Extension Tools<br/>[extensions.py]"]
  node_types["Tool Definitions<br/>[types.py]"]
end

subgraph group_security["Access Control"]
  node_tokens[("Token Store<br/>[token_store.py]")]
  node_oauth["OAuth Provider<br/>[oauth_provider.py]"]
end

subgraph group_admin["Admin Portal"]
  node_adminapp["Admin Application<br/>[app.py]"]
  node_adminviews["Admin Views"]
  node_adminauth["Admin Authentication<br/>[auth.py]"]
  node_configwriter["Config Writer<br/>[config_writer.py]"]
  node_audit[("Audit Log<br/>[audit_writer.py]")]
end

subgraph group_reports["Reporting"]
  node_reportengine["Report Engine<br/>[engine.py]"]
  node_reportfetch["Report Data Fetcher<br/>[data_fetcher.py]"]
  node_reportstore[("Report Store<br/>[store.py]")]
  node_delivery["Report Delivery<br/>[delivery.py]"]
end

node_ai(("AI Client"))
node_zabbix["Zabbix Instance"]

node_ai -->|"sends requests"| node_mcp
node_mcp -->|"dispatches calls"| node_zclient
node_zclient -->|"calls API"| node_zabbix
node_mcp -->|"loads settings"| node_config
node_mcp -->|"checks tokens"| node_tokens
node_mcp -.->|"registers tools"| node_common
node_mcp -.->|"registers tools"| node_collection
node_mcp -.->|"registers tools"| node_monitoring
node_mcp -.->|"registers tools"| node_alerts
node_mcp -.->|"registers tools"| node_usersapi
node_mcp -.->|"registers tools"| node_administration
node_mcp -->|"registers tools"| node_extensions
node_mcp -->|"configures provider"| node_oauth
node_collection -->|"uses definitions"| node_common
node_monitoring -->|"uses definitions"| node_common
node_administration -->|"uses definitions"| node_common
node_collection -->|"uses types"| node_types
node_monitoring -->|"uses types"| node_types
node_administration -->|"uses types"| node_types
node_mcp -->|"generates reports"| node_reportengine
node_mcp -->|"stores reports"| node_reportstore
node_mcp -->|"loads report data"| node_reportfetch
node_mcp -->|"delivers reports"| node_delivery
node_reportfetch -->|"fetches Zabbix data"| node_zclient
node_adminapp -->|"routes requests"| node_adminviews
node_adminviews -->|"updates configuration"| node_configwriter
node_adminviews -->|"manages tokens"| node_tokens
node_adminviews -->|"writes audit events"| node_audit
node_adminapp -->|"authenticates admins"| node_adminauth
node_adminviews -->|"manages OAuth clients"| node_oauth

click node_mcp "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/server.py"
click node_config "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/config.py"
click node_zclient "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/client.py"
click node_common "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/common.py"
click node_collection "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/data_collection.py"
click node_monitoring "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/monitoring.py"
click node_alerts "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/alerts.py"
click node_usersapi "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/users.py"
click node_administration "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/administration.py"
click node_extensions "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/extensions.py"
click node_types "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/types.py"
click node_tokens "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/token_store.py"
click node_oauth "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/oauth_provider.py"
click node_adminapp "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/app.py"
click node_adminviews "https://github.com/initmax/zabbix-mcp-server/tree/main/src/zabbix_mcp/admin/views"
click node_adminauth "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/auth.py"
click node_configwriter "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/config_writer.py"
click node_audit "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/audit_writer.py"
click node_reportengine "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/engine.py"
click node_reportfetch "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/data_fetcher.py"
click node_reportstore "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/store.py"
click node_delivery "https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/delivery.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp,node_config,node_zclient,node_ai toneBlue
class node_common,node_collection,node_monitoring,node_alerts,node_usersapi,node_administration,node_extensions,node_types toneAmber
class node_tokens,node_oauth toneMint
class node_adminapp,node_adminviews,node_adminauth,node_configwriter,node_audit toneRose
class node_reportengine,node_reportfetch,node_reportstore,node_delivery,node_zabbix toneIndigo
```

## Components

### MCP Runtime

- [MCP Server](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/server.py): `src/zabbix_mcp/server.py`
- [Configuration](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/config.py): `src/zabbix_mcp/config.py`
- [Zabbix Client](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/client.py): `src/zabbix_mcp/client.py`

### Zabbix API Tools

- [API Common](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/common.py): `src/zabbix_mcp/api/common.py`
- [Data Collection](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/data_collection.py): `src/zabbix_mcp/api/data_collection.py`
- [Monitoring Tools](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/monitoring.py): `src/zabbix_mcp/api/monitoring.py`
- [Alert Tools](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/alerts.py): `src/zabbix_mcp/api/alerts.py`
- [User Tools](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/users.py): `src/zabbix_mcp/api/users.py`
- [Administration Tools](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/administration.py): `src/zabbix_mcp/api/administration.py`
- [Extension Tools](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/extensions.py): `src/zabbix_mcp/api/extensions.py`
- [Tool Definitions](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/api/types.py): `src/zabbix_mcp/api/types.py`

### Access Control

- [Token Store](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/token_store.py): `src/zabbix_mcp/token_store.py`
- [OAuth Provider](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/oauth_provider.py): `src/zabbix_mcp/oauth_provider.py`

### Admin Portal

- [Admin Application](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/app.py): `src/zabbix_mcp/admin/app.py`
- [Admin Views](https://github.com/initmax/zabbix-mcp-server/tree/main/src/zabbix_mcp/admin/views): `src/zabbix_mcp/admin/views`
- [Admin Authentication](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/auth.py): `src/zabbix_mcp/admin/auth.py`
- [Config Writer](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/config_writer.py): `src/zabbix_mcp/admin/config_writer.py`
- [Audit Log](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/admin/audit_writer.py): `src/zabbix_mcp/admin/audit_writer.py`

### Reporting

- [Report Engine](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/engine.py): `src/zabbix_mcp/reporting/engine.py`
- [Report Data Fetcher](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/data_fetcher.py): `src/zabbix_mcp/reporting/data_fetcher.py`
- [Report Store](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/store.py): `src/zabbix_mcp/reporting/store.py`
- [Report Delivery](https://github.com/initmax/zabbix-mcp-server/blob/main/src/zabbix_mcp/reporting/delivery.py): `src/zabbix_mcp/reporting/delivery.py`

### Other components

- **AI Client**
- **Zabbix Instance**

## Connections

- AI Client → MCP Server: sends requests (evidence: `README.md`)
- MCP Server → Zabbix Client: dispatches calls (evidence: `src/zabbix_mcp/server.py`)
- Zabbix Client → Zabbix Instance: calls API (evidence: `README.md`)
- MCP Server → Configuration: loads settings (evidence: `src/zabbix_mcp/server.py`)
- MCP Server → Token Store: checks tokens (evidence: `src/zabbix_mcp/server.py`)
- MCP Server → API Common: registers tools
- MCP Server → Data Collection: registers tools
- MCP Server → Monitoring Tools: registers tools
- MCP Server → Alert Tools: registers tools
- MCP Server → User Tools: registers tools
- MCP Server → Administration Tools: registers tools
- MCP Server → Extension Tools: registers tools (evidence: `src/zabbix_mcp/server.py`)
- MCP Server → OAuth Provider: configures provider (evidence: `src/zabbix_mcp/server.py`)
- Data Collection → API Common: uses definitions (evidence: `src/zabbix_mcp/api/data_collection.py`)
- Monitoring Tools → API Common: uses definitions (evidence: `src/zabbix_mcp/api/monitoring.py`)
- Administration Tools → API Common: uses definitions (evidence: `src/zabbix_mcp/api/administration.py`)
- Data Collection → Tool Definitions: uses types (evidence: `src/zabbix_mcp/api/data_collection.py`)
- Monitoring Tools → Tool Definitions: uses types (evidence: `src/zabbix_mcp/api/monitoring.py`)
- Administration Tools → Tool Definitions: uses types (evidence: `src/zabbix_mcp/api/administration.py`)
- MCP Server → Report Engine: generates reports (evidence: `src/zabbix_mcp/server.py`)
- MCP Server → Report Store: stores reports (evidence: `src/zabbix_mcp/server.py`)
- MCP Server → Report Data Fetcher: loads report data (evidence: `src/zabbix_mcp/server.py`)
- MCP Server → Report Delivery: delivers reports (evidence: `src/zabbix_mcp/server.py`)
- Report Data Fetcher → Zabbix Client: fetches Zabbix data (evidence: `src/zabbix_mcp/reporting/data_fetcher.py`)
- Admin Application → Admin Views: routes requests (evidence: `src/zabbix_mcp/admin/app.py`)
- Admin Views → Config Writer: updates configuration (evidence: `src/zabbix_mcp/admin/views/servers.py`)
- Admin Views → Token Store: manages tokens (evidence: `src/zabbix_mcp/admin/views/tokens.py`)
- Admin Views → Audit Log: writes audit events (evidence: `src/zabbix_mcp/admin/views/servers.py`)
- Admin Application → Admin Authentication: authenticates admins (evidence: `src/zabbix_mcp/admin/app.py`)
- Admin Views → OAuth Provider: manages OAuth clients (evidence: `src/zabbix_mcp/admin/views/oauth_clients.py`)
