How initmax/zabbix-mcp-server works
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: server.py MCP Server · views Admin Views · common.py API Common · data_collection.py Data Collection
Components 24
MCP Runtime
- MCP Server
src/zabbix_mcp/server.py - Configuration
src/zabbix_mcp/config.py - Zabbix Client
src/zabbix_mcp/client.py
Zabbix API Tools
- API Common
src/zabbix_mcp/api/common.py - Data Collection
src/zabbix_mcp/api/data_collection.py - Monitoring Tools
src/zabbix_mcp/api/monitoring.py - Alert Tools
src/zabbix_mcp/api/alerts.py - User Tools
src/zabbix_mcp/api/users.py - Administration Tools
src/zabbix_mcp/api/administration.py - Extension Tools
src/zabbix_mcp/api/extensions.py - Tool Definitions
src/zabbix_mcp/api/types.py
Access Control
- Token Store
src/zabbix_mcp/token_store.py - OAuth Provider
src/zabbix_mcp/oauth_provider.py
Admin Portal
- Admin Application
src/zabbix_mcp/admin/app.py - Admin Views
src/zabbix_mcp/admin/views - Admin Authentication
src/zabbix_mcp/admin/auth.py - Config Writer
src/zabbix_mcp/admin/config_writer.py - Audit Log
src/zabbix_mcp/admin/audit_writer.py
Reporting
- Report Engine
src/zabbix_mcp/reporting/engine.py - Report Data Fetcher
src/zabbix_mcp/reporting/data_fetcher.py - Report Store
src/zabbix_mcp/reporting/store.py - Report Delivery
src/zabbix_mcp/reporting/delivery.py
Other components
- AI Client
- Zabbix Instance
Connections 30
- AI Client → MCP Server: sends requests
README.md - MCP Server → Zabbix Client: dispatches calls
src/zabbix_mcp/server.py - Zabbix Client → Zabbix Instance: calls API
README.md - MCP Server → Configuration: loads settings
src/zabbix_mcp/server.py - MCP Server → Token Store: checks tokens
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
src/zabbix_mcp/server.py - MCP Server → OAuth Provider: configures provider
src/zabbix_mcp/server.py - Data Collection → API Common: uses definitions
src/zabbix_mcp/api/data_collection.py - Monitoring Tools → API Common: uses definitions
src/zabbix_mcp/api/monitoring.py - Administration Tools → API Common: uses definitions
src/zabbix_mcp/api/administration.py - Data Collection → Tool Definitions: uses types
src/zabbix_mcp/api/data_collection.py - Monitoring Tools → Tool Definitions: uses types
src/zabbix_mcp/api/monitoring.py - Administration Tools → Tool Definitions: uses types
src/zabbix_mcp/api/administration.py - MCP Server → Report Engine: generates reports
src/zabbix_mcp/server.py - MCP Server → Report Store: stores reports
src/zabbix_mcp/server.py - MCP Server → Report Data Fetcher: loads report data
src/zabbix_mcp/server.py - MCP Server → Report Delivery: delivers reports
src/zabbix_mcp/server.py - Report Data Fetcher → Zabbix Client: fetches Zabbix data
src/zabbix_mcp/reporting/data_fetcher.py - Admin Application → Admin Views: routes requests
src/zabbix_mcp/admin/app.py - Admin Views → Config Writer: updates configuration
src/zabbix_mcp/admin/views/servers.py - Admin Views → Token Store: manages tokens
src/zabbix_mcp/admin/views/tokens.py - Admin Views → Audit Log: writes audit events
src/zabbix_mcp/admin/views/servers.py - Admin Application → Admin Authentication: authenticates admins
src/zabbix_mcp/admin/app.py - Admin Views → OAuth Provider: manages OAuth clients
src/zabbix_mcp/admin/views/oauth_clients.py