System Information MCP Server

Instructions

Implementation Reference

• src/sysinfo/server.py:46-73 (handler)

  The primary handler function for the 'get_system_summary' tool. Decorated with @mcp.tool for automatic registration in the FastMCP server. Collects essential system information using helper functions get_system_identity() and get_hardware_info(), filters key hardware metrics, formats output as markdown sections with timestamp, handles exceptions, and returns a ToolResult with text content.

  @mcp.tool
  def get_system_summary() -> ToolResult:
      """Get essential system overview - hostname, OS, CPU, RAM, uptime.
      
      Quick system identity check without heavy data collection.
      Perfect for basic system verification and health checks.
      """
      info_sections = []
      info_sections.append("# System Summary")
      info_sections.append(f"*Generated: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}*\n")
      
      try:
          # Just the essentials from system identity and hardware
          identity_info = get_system_identity()
          hardware_info = get_hardware_info()
          
          # Extract key lines only
          info_sections.extend(identity_info)
          
          # Add just CPU, RAM, and uptime from hardware
          for line in hardware_info:
              if any(keyword in line for keyword in ['CPU Cores:', 'CPU Usage:', 'Total RAM:', 'Available RAM:', 'Boot Time:', 'Uptime:']):
                  info_sections.append(line)
                  
      except Exception as e:
          info_sections.append(f"⚠️ **Error**: {str(e)}")
      
      return text_response("\n".join(info_sections))