Для чего этот сервер?

Этот сервер соединяет ИИ-ассистентов с Zabbix через протокол MCP. Он даёт полный доступ к Zabbix API всего тремя инструментами вместо сотни отдельных. Так языковая модель тратит меньше контекста, а интеграция остаётся актуальной при любых обновлениях Zabbix. Разработчикам и администраторам не нужно вручную писать десятки инструментов или переписывать их при смене API.

Что он умеет?

Сервер открывает доступ ко всему Zabbix API через три инструмента: выполняет любые API-методы - читает хосты, проблемы, триггеры и события, создаёт и обновляет объекты мониторинга, управляет конфигурацией. Подсказывает разработчику: перечисляет доступные объекты и методы API, а перед вызовом показывает документацию по параметрам конкретного метода. Поддерживает read-only режим и фильтрацию методов через белый и чёрный списки.

Каталог MCP
mpeirone/zabbix-mcp-server

mpeirone/zabbix-mcp-server

от mpeirone

MCP-сервер предоставляет полный доступ к Zabbix API всего через три инструмента. Управляйте мониторингом, получайте данные о хостах и проблемах, автоматизируйте задачи без лишних инструментов. Совм...

Github Сайт сервера

README

3 инструмента

Версии

Установить сервер

Zabbix MCP Server

A lightweight Model Context Protocol (MCP) server that provides complete access to the entire Zabbix API through just 3 tools. Compatible with Zabbix 6.0+.

Why Zabbix MCP Server?

Complete API Coverage - Access every Zabbix API method (100+) through a unified interface
Lightweight Context - Only 3 tools instead of 50+ individual tools, keeping LLM context minimal
Always Up-to-Date - Works with current and future Zabbix API methods automatically
Zabbix 6.0+ Compatible - Supports Zabbix 6.0, 6.4, 7.0, and newer versions

The 3 Tools

Tool	Purpose
`zabbix_api`	Execute any Zabbix API method
`zabbix_api_docs`	Get documentation for any API method
`zabbix_api_list`	Discover available API objects and methods

Quick Start

Option 1: Claude Code Integration

Add to your Claude Code MCP configuration:

claude mcp add zabbix \
  --env ZABBIX_URL=https://your-zabbix-server.com \
  --env ZABBIX_TOKEN=your_api_token \
  -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp

Option 2: Run with uv

Часто задаваемые вопросы

Инструменты были проиндексированы: 16.10.2026

zabbix_api

Zabbix server: https://zabbix.example.com Выполнить метод Zabbix API. Это основной инструмент для работы с Zabbix. Чтобы достичь сложных целей, требуется несколько итераций. Для подсказок используйте другие инструменты. ПОСЛЕДОВАТЕЛЬНОСТЬ ДЕЙСТВИЙ: 1. Если не уверены в методе/параметрах: сначала вызовите zabbix_api_docs(method) 2. Если не уверены, какие методы доступны: сначала вызовите zabbix_api_list() 3. Выполните вызов API с помощью этого инструмента 4. Если результат пуст или ошибка: повторите с другими параметрами/фильтрами 5. Продолжайте итерации, пока цель не достигнута ТИПОВЫЕ ПРИЁМЫ: - Чтобы найти объект, нужно 2+ вызова (найти ID, затем получить детали) - Пример с загрузкой CPU: найти хост по имени, получить его элементы данных, отфильтровать элемент CPU, получить историю - Пустые результаты часто означают неверные фильтры — сначала пробуйте более широкий поиск

Параметры

methodstringобязательный
Метод API Zabbix (формат: 'object.action').
paramsobject | null
Параметры метода (необязательно). Для операций 'get',

zabbix_api_docs

Получить документацию по методам Zabbix API. Вызывайте это ДО zabbix_api(), если сомневаетесь в параметрах метода. Показывает обязательные/необязательные параметры с типами и описаниями.

Параметры

methodstringобязательный
Метод API Zabbix (формат: 'object.action').
timeoutinteger | null
Тайм-аут HTTP в секундах (по умолчанию: 10).
versionstring | null
Версия Zabbix (например, '7.0', '6.0'). Если не указана, используется версия сервера.

zabbix_api_list

Получить доступные объекты и методы Zabbix API. Вызовите это, чтобы узнать, какие методы API доступны перед использованием zabbix_api(). Возвращает все объекты и методы, динамически обнаруженные из Zabbix API.

Параметры

objectstring | null
Конкретный объект API (например, 'host', 'item'). Если не указано, возвращает все.

Выберите клиент, чтобы установить mpeirone/zabbix-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx"
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx"
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "type": "stdio",
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"mpeirone-zabbix-mcp-server-dg2upx59pe\",\"type\":\"stdio\",\"env\":{\"ZABBIX_URL\":\"https://zabbix.example.com\",\"ZABBIX_TOKEN\":\"your_api_token\"},\"args\":[\"--from\",\"git+https://github.com/mpeirone/zabbix-mcp-server@main\",\"zabbix-mcp\"],\"command\":\"uvx\"}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx"
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add mpeirone-zabbix-mcp-server-dg2upx59pe --env ZABBIX_URL=https://zabbix.example.com --env ZABBIX_TOKEN=your_api_token -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp

Либо через JSON-конфиг:

claude mcp add-json mpeirone-zabbix-mcp-server-dg2upx59pe "{\"env\":{\"ZABBIX_URL\":\"https://zabbix.example.com\",\"ZABBIX_TOKEN\":\"your_api_token\"},\"args\":[\"--from\",\"git+https://github.com/mpeirone/zabbix-mcp-server@main\",\"zabbix-mcp\"],\"command\":\"uvx\"}"

Codex

Добавьте сервер командой в терминале:

codex mcp add mpeirone-zabbix-mcp-server-dg2upx59pe --env ZABBIX_URL=https://zabbix.example.com --env ZABBIX_TOKEN=your_api_token -- uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.mpeirone-zabbix-mcp-server-dg2upx59pe]
command = "uvx"
args = ["--from", "git+https://github.com/mpeirone/zabbix-mcp-server@main", "zabbix-mcp"]

[mcp_servers.mpeirone-zabbix-mcp-server-dg2upx59pe.env]
ZABBIX_URL = "https://zabbix.example.com"
ZABBIX_TOKEN = "your_api_token"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите mpeirone/zabbix-mcp-server, а в поле команды запуска — строку ниже:

uvx --from git+https://github.com/mpeirone/zabbix-mcp-server@main zabbix-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx"
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например mpeirone-zabbix-mcp-server-dg2upx59pe.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: mpeirone-zabbix-mcp-server-dg2upx59pe
    command: uvx
    args:
      - "--from"
      - "git+https://github.com/mpeirone/zabbix-mcp-server@main"
      - "zabbix-mcp"
    env:
      ZABBIX_URL: https://zabbix.example.com
      ZABBIX_TOKEN: your_api_token

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "mpeirone-zabbix-mcp-server-dg2upx59pe": {
      "env": {
        "ZABBIX_URL": "https://zabbix.example.com",
        "ZABBIX_TOKEN": "your_api_token"
      },
      "args": [
        "--from",
        "git+https://github.com/mpeirone/zabbix-mcp-server@main",
        "zabbix-mcp"
      ],
      "command": "uvx"
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/mpeirone/zabbix-mcp-server@main",
    "zabbix-mcp"
  ],
  "env": {
    "ZABBIX_URL": "https://zabbix.example.com",
    "ZABBIX_TOKEN": "your_api_token"
  }
}