zabbix-mcp-server

Instructions

Implementation Reference

• src/zabbix_mcp_server.py:114-154 (handler)

  The primary handler for the 'host_get' MCP tool. Decorated with @mcp.tool() for automatic registration. Fetches hosts from Zabbix API using provided filter parameters, formats and returns JSON response.
  @mcp.tool() def host_get(hostids: Optional[List[str]] = None, groupids: Optional[List[str]] = None, templateids: Optional[List[str]] = None, output: Union[str, List[str]] = "extend", search: Optional[Dict[str, str]] = None, filter: Optional[Dict[str, Any]] = None, limit: Optional[int] = None) -> str: """Get hosts from Zabbix with optional filtering. Args: hostids: List of host IDs to retrieve groupids: List of host group IDs to filter by templateids: List of template IDs to filter by output: Output format (extend or list of specific fields) search: Search criteria filter: Filter criteria limit: Maximum number of results Returns: str: JSON formatted list of hosts """ client = get_zabbix_client() params = {"output": output} if hostids: params["hostids"] = hostids if groupids: params["groupids"] = groupids if templateids: params["templateids"] = templateids if search: params["search"] = search if filter: params["filter"] = filter if limit: params["limit"] = limit result = client.host.get(**params) return format_response(result)
• src/zabbix_mcp_server.py:38-80 (helper)

  Helper function used by host_get to obtain an authenticated ZabbixAPI client instance.
  def get_zabbix_client() -> ZabbixAPI: """Get or create Zabbix API client with proper authentication. Returns: ZabbixAPI: Authenticated Zabbix API client Raises: ValueError: If required environment variables are missing Exception: If authentication fails """ global zabbix_api if zabbix_api is None: url = os.getenv("ZABBIX_URL") if not url: raise ValueError("ZABBIX_URL environment variable is required") logger.info(f"Initializing Zabbix API client for {url}") # Configure SSL verification verify_ssl = os.getenv("VERIFY_SSL", "true").lower() in ("true", "1", "yes") logger.info(f"SSL certificate verification: {'enabled' if verify_ssl else 'disabled'}") # Initialize client zabbix_api = ZabbixAPI(url=url, validate_certs=verify_ssl) # Authenticate using token or username/password token = os.getenv("ZABBIX_TOKEN") if token: logger.info("Authenticating with API token") zabbix_api.login(token=token) else: user = os.getenv("ZABBIX_USER") password = os.getenv("ZABBIX_PASSWORD") if not user or not password: raise ValueError("Either ZABBIX_TOKEN or ZABBIX_USER/ZABBIX_PASSWORD must be set") logger.info(f"Authenticating with username: {user}") zabbix_api.login(user=user, password=password) logger.info("Successfully authenticated with Zabbix API") return zabbix_api
• src/zabbix_mcp_server.py:91-100 (helper)

  Helper function used by host_get to format the API response as indented JSON string.
  def format_response(data: Any) -> str: """Format response data as JSON string. Args: data: Data to format Returns: str: JSON formatted string """ return json.dumps(data, indent=2, default=str)
• src/zabbix_mcp_server.py:115-135 (schema)

  Input schema defined by function parameters with type hints and comprehensive docstring describing Args and Returns for the host_get tool.
  def host_get(hostids: Optional[List[str]] = None, groupids: Optional[List[str]] = None, templateids: Optional[List[str]] = None, output: Union[str, List[str]] = "extend", search: Optional[Dict[str, str]] = None, filter: Optional[Dict[str, Any]] = None, limit: Optional[int] = None) -> str: """Get hosts from Zabbix with optional filtering. Args: hostids: List of host IDs to retrieve groupids: List of host group IDs to filter by templateids: List of template IDs to filter by output: Output format (extend or list of specific fields) search: Search criteria filter: Filter criteria limit: Maximum number of results Returns: str: JSON formatted list of hosts """
• src/zabbix_mcp_server.py:114-114 (registration)

  The @mcp.tool() decorator registers the host_get function as an MCP tool with FastMCP.
  @mcp.tool()