Frida Game Hacking MCP

Instructions

List all running processes.

Args:
    filter_name: Optional filter to match process names (case-insensitive)

Returns:
    List of processes with PID and name.

Implementation Reference

• src/frida_game_hacking_mcp/server.py:351-380 (handler)

  The main handler function for the 'list_processes' tool. It uses Frida to enumerate running processes on the local device, filters by name if provided, sorts them alphabetically, limits to 100 results, and returns a dictionary with count and list of processes (PID and name). Handles Frida not available and exceptions.

  @mcp.tool()
  def list_processes(filter_name: str = "") -> Dict[str, Any]:
      """
      List all running processes.
      
      Args:
          filter_name: Optional filter to match process names (case-insensitive)
      
      Returns:
          List of processes with PID and name.
      """
      if not FRIDA_AVAILABLE:
          return {"error": "Frida not installed. Run: pip install frida frida-tools"}
      
      try:
          device = get_device()
          processes = device.enumerate_processes()
          
          result = []
          for proc in processes:
              if filter_name and filter_name.lower() not in proc.name.lower():
                  continue
              result.append({"pid": proc.pid, "name": proc.name})
          
          result.sort(key=lambda x: x["name"].lower())
          return {"count": len(result), "processes": result[:100]}
      
      except Exception as e:
          return {"error": f"Failed to enumerate processes: {str(e)}"}