Unix Manual Server

Instructions

Implementation Reference

• unix_manual_server.py:248-309 (handler)

  The handler function for the 'list_common_commands' tool. It scans common Unix directories (/bin, /usr/bin, /usr/local/bin) for executable files, collects unique commands, categorizes them into File Operations, Text Processing, System Information, and Networking, and returns a formatted string listing them. Registered via @mcp.tool() decorator.

  @mcp.tool()
  def list_common_commands() -> str:
      """
      List common Unix commands available on the system.
  
      Returns:
          A list of common Unix commands
      """
      logger.info("Listing common commands")
      # Define common directories in PATH that contain commands
      common_dirs = ['/bin', '/usr/bin', '/usr/local/bin']
      logger.debug(f"Searching in directories: {common_dirs}")
  
      commands = []
      for directory in common_dirs:
          if os.path.exists(directory) and os.path.isdir(directory):
              logger.debug(f"Scanning directory: {directory}")
              # List only executable files
              try:
                  for file in os.listdir(directory):
                      file_path = os.path.join(directory, file)
                      if os.path.isfile(file_path) and os.access(file_path, os.X_OK):
                          commands.append(file)
              except Exception as e:
                  logger.error(f"Error listing directory {directory}: {str(e)}")
  
      # Remove duplicates and sort
      commands = sorted(set(commands))
      logger.info(f"Found {len(commands)} unique commands")
  
      # Return a formatted string with command categories
      result = "Common Unix commands available on this system:\n\n"
  
      # File operations
      file_cmds = [cmd for cmd in commands if cmd in ['ls', 'cp', 'mv', 'rm', 'mkdir', 'touch', 'chmod', 'chown', 'find', 'grep']]
      if file_cmds:
          logger.debug(f"File operation commands found: {len(file_cmds)}")
          result += "File Operations:\n" + ", ".join(file_cmds) + "\n\n"
  
      # Text processing
      text_cmds = [cmd for cmd in commands if cmd in ['cat', 'less', 'more', 'head', 'tail', 'grep', 'sed', 'awk', 'sort', 'uniq', 'wc']]
      if text_cmds:
          logger.debug(f"Text processing commands found: {len(text_cmds)}")
          result += "Text Processing:\n" + ", ".join(text_cmds) + "\n\n"
  
      # System information
      sys_cmds = [cmd for cmd in commands if cmd in ['ps', 'top', 'htop', 'df', 'du', 'free', 'uname', 'uptime', 'who', 'whoami']]
      if sys_cmds:
          logger.debug(f"System info commands found: {len(sys_cmds)}")
          result += "System Information:\n" + ", ".join(sys_cmds) + "\n\n"
  
      # Network tools
      net_cmds = [cmd for cmd in commands if cmd in ['ping', 'netstat', 'ifconfig', 'ip', 'ssh', 'scp', 'curl', 'wget']]
      if net_cmds:
          logger.debug(f"Networking commands found: {len(net_cmds)}")
          result += "Networking:\n" + ", ".join(net_cmds) + "\n\n"
  
      # Show total count
      result += f"Total commands found: {len(commands)}\n"
      result += "Use get_command_documentation() to learn more about any command."
  
      return result