zabbix-mcp-server

Instructions

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, shorten, or specific fields)
    search: Search criteria
    filter: Filter criteria
    limit: Maximum number of results
    
Returns:
    str: JSON formatted list of hosts

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()