本文基于开源项目 mpeirone/zabbix-mcp-server介绍如何通过 MCPModel Context Protocol协议将 Zabbix 监控系统与 AI 助手深度集成并详细讲解 Zabbix API Token 的获取方式。一、背景为什么需要 AI ZabbixZabbix 是企业级 IT 监控的主流开源平台拥有强大的数据采集、告警和可视化能力。但传统运维流程中排查告警、查询主机状态、分析趋势数据往往需要大量的手工操作——登录 Web 界面、翻看图表、比对配置……zabbix-mcp-server打破了这道壁垒。它基于Model Context ProtocolMCP协议将 Zabbix 的 40 个 API 能力封装成可被 AI 助手直接调用的工具Tool。借助它你可以对 AI 说一句话帮我找出过去一小时内所有 CPU 告警的主机并统计触发次数。AI 就会自动调用 Zabbix API返回结构化结果——不再需要你一行一行敲命令。二、项目概览属性信息项目地址https://github.com/mpeirone/zabbix-mcp-server开发语言Python 3.10核心依赖FastMCP、python-zabbix-utils传输方式STDIO默认/ HTTP许可证MIT License工具数量40核心功能一览功能模块能做什么 主机管理获取、创建、更新、删除主机 主机组管理主机组的增删改查 监控项管理监控项配置与查询⚠️ 触发器管理触发器的创建与维护 模板管理模板操作 问题/事件获取当前问题、历史事件、确认事件 数据查询历史数据、趋势数据 用户管理用户账户管理 代理管理Zabbix Proxy 操作 维护管理维护窗口配置 其他图形配置、自动发现、配置导入导出三、Zabbix API Token 获取方法重点在使用 zabbix-mcp-server 之前你需要先获取 Zabbix 的 API Token或用户名/密码。下面介绍两种主流方式方式一通过 Web 界面创建 API TokenZabbix 5.4推荐Zabbix 5.4 起引入了永久 API Token机制无需每次通过用户名密码登录换取临时 Token非常适合 CI/CD 和长期集成场景。操作步骤以 Zabbix 6.x / 7.x 为例以管理员身份登录 Zabbix Web 界面点击左下角User settings用户设置选择API tokensAPI 令牌标签页点击右上角Create API token创建 API 令牌填写令牌名称选择关联用户可选设置过期时间点击Add添加完成创建⚠️ 重要令牌值只显示一次请立即复制并妥善保存路径小结不同版本Zabbix 6.xAdministration → General → API Tokens或用户设置页Zabbix 7.xUser settings → API tokens创建后的 Token 形如abc1234def5678...64位十六进制字符串方式二通过user.loginAPI 动态获取 Token这是 Zabbix 5.4 之前的经典方式适用于脚本临时认证场景。Token 与用户 Session 绑定Session 失效需重新获取。使用 curl 获取curl --request POST \ --url http://your-zabbix-server/api_jsonrpc.php \ --header Content-Type: application/json-rpc \ --data { jsonrpc: 2.0, method: user.login, params: { username: Admin, password: zabbix }, id: 1 }成功响应{ jsonrpc: 2.0, result: 0424bd59b807674191e7d77572075f33, id: 1 }result字段的值即为本次会话的认证 Token。使用 Shell 脚本自动提取 Token依赖需先安装jqapt install jq或yum install jq使用 Python 获取 Token方式三通过 Zabbix API 以编程方式创建永久 TokenZabbix 5.4如果你需要在脚本中自动化创建永久 Token可先用用户名密码获取会话 Token再调用token.create和token.generateToken 获取方式对比特性user.login会话 TokenWeb 界面创建永久 TokenAPI 编程创建永久 Token适用版本所有版本Zabbix 5.4Zabbix 5.4有效期与 Session 绑定可设置固定期限可设置固定期限使用场景脚本、临时调用长期集成、MCP服务自动化部署安全性中需存储账号密码高只需保存 Token高自动化流程推荐程度⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐四、安装与配置 zabbix-mcp-server环境要求Python 3.10uv 包管理器可访问的 Zabbix 服务器已启用 API安装步骤# 1. 克隆项目 git clone https://github.com/mpeirone/zabbix-mcp-server.git cd zabbix-mcp-server # 2. 安装依赖 uv sync # 3. 复制并编辑配置文件 cp config/.env.example .env配置 .env 文件# Zabbix 服务器地址必填 ZABBIX_URLhttps://your-zabbix-server.example.com # 认证方式一API Token推荐Zabbix 5.4 ZABBIX_TOKENyour_api_token_here # 认证方式二用户名/密码二选一 # ZABBIX_USERAdmin # ZABBIX_PASSWORDyour_password # 可选只读模式防止误操作 # READ_ONLYtrue # 可选SSL 证书验证 # VERIFY_SSLtrue测试安装uv run python scripts/test_server.py启动服务器# 推荐方式 uv run python scripts/start_server.py # 或直接运行 uv run python src/zabbix_mcp_server.py五、Docker 快速部署如果不想配置 Python 环境可以直接用 Docker# 配置环境变量 cp config/.env.example .env # 编辑 .env 填入你的 Zabbix 配置 # 启动服务 docker compose up -ddocker-compose.yml示例version: 3 services: zabbix-mcp: build: . env_file: .env restart: unless-stopped六、集成到 AI 助手以 Claude Desktop 为例安装完成后将服务注册到 Claude Desktop 的 MCP 配置中编辑~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS{ mcpServers: { zabbix: { command: uv, args: [ --directory, /path/to/zabbix-mcp-server, run, python, src/zabbix_mcp_server.py ], env: { ZABBIX_URL: https://your-zabbix-server.example.com, ZABBIX_TOKEN: your_api_token_here } } } }重启 Claude Desktop 后你就可以直接用自然语言操作 Zabbix 了七、实际使用示例配置完成后你可以这样和 AI 对话查看当前告警帮我列出所有 severity 为 High 的未解决问题分析主机性能查看服务器 web-server-01 最近 1 小时的 CPU 使用率趋势批量操作将主机组 Testing 中的所有主机禁用监控配置管理帮我创建一个名为 nginx-monitor 的监控项监控 nginx 进程数只读安全模式在.env中设置READ_ONLYtrueAI 只能查询不能修改适合只读看板场景八、安全注意事项优先使用 API Token 而非用户名密码Token 泄露可立即撤销密码泄露影响范围更大为 MCP 集成创建专用只读账户最小权限原则设置 Token 有效期避免长期有效的 Token 被滥用生产环境启用 VERIFY_SSLtrue防止中间人攻击保护 .env 文件不要将其提交到 Git 仓库已在 .gitignore 中排除只读模式优先如无需写入操作务必设置READ_ONLYtrue九、总结zabbix-mcp-server是一个将监控运维与 AI 能力融合的创新实践。通过 MCP 协议繁琐的 Zabbix 操作变成了简单的自然语言对话极大降低了运维门槛。关键步骤回顾✅ 获取 Zabbix API Token推荐 Web 界面直接创建永久 Token✅ 配置.env环境变量✅ 启动 MCP 服务uv 或 Docker✅ 集成到 Claude Desktop 等 AI 助手✅ 用自然语言驾驭 Zabbix参考资料mpeirone/zabbix-mcp-server GitHubZabbix 官方 API 文档Zabbix 7.0 API 使用手册书栈网Model Context Protocol 官网FastMCP 项目作者运维 AI 探索者 | 发布于 2026-03-30